> ## Documentation Index
> Fetch the complete documentation index at: https://www.myhamlet.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get a meeting's agenda

> Returns the meeting's agenda as a hierarchical tree of items, nested by parent into `children` and ordered as published. Not paginated — the full tree is returned in one call. If the meeting has more than one agenda, the most recently updated is returned. Returns 404 if the meeting does not exist, your API key is not entitled to it, or it has no agenda (`has_agenda` on the meeting list tells you in advance).



## OpenAPI

````yaml /openapi.json get /v1/meetings/{uuid}/agenda
openapi: 3.1.0
info:
  title: Hamlet Public API
  version: 0.1.0
  description: >-
    Public API for programmatic access to Hamlet civic intelligence data:
    government meetings, transcripts, and related records from local
    governments.
servers:
  - url: https://api.myhamlet.com
    description: Production
security: []
paths:
  /v1/meetings/{uuid}/agenda:
    get:
      tags:
        - Meetings
      summary: Get a meeting's agenda
      description: >-
        Returns the meeting's agenda as a hierarchical tree of items, nested by
        parent into `children` and ordered as published. Not paginated — the
        full tree is returned in one call. If the meeting has more than one
        agenda, the most recently updated is returned. Returns 404 if the
        meeting does not exist, your API key is not entitled to it, or it has no
        agenda (`has_agenda` on the meeting list tells you in advance).
      parameters:
        - schema:
            type: string
            format: uuid
            description: The meeting's public uuid.
            example: 9a1c2b3d-4e5f-6071-8293-a4b5c6d7e8f9
          required: true
          description: The meeting's public uuid.
          name: uuid
          in: path
      responses:
        '200':
          description: The meeting's agenda as a hierarchical tree.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Agenda'
        '400':
          description: Invalid uuid.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: >-
            The meeting does not exist, is not entitled to this API key, or has
            no agenda.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    Agenda:
      type: object
      properties:
        uuid:
          type: string
          description: The agenda's public identifier.
          example: 7b44c1e2-...
        meeting_uuid:
          type: string
          description: The meeting's public identifier; matches the path.
          example: 9a1c...
        created_at:
          type: string
          description: ISO-8601 UTC timestamp.
          example: '2026-05-19T18:00:00.000Z'
        updated_at:
          type: string
          description: ISO-8601 UTC timestamp.
          example: '2026-05-19T18:00:00.000Z'
        items:
          type: array
          items:
            $ref: '#/components/schemas/AgendaItem'
          description: Top-level items (those with no parent), ordered.
      required:
        - uuid
        - meeting_uuid
        - created_at
        - updated_at
        - items
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              example: not_found
            message:
              type: string
              example: The requested resource was not found.
          required:
            - code
            - message
      required:
        - error
    AgendaItem:
      type: object
      properties:
        item_number:
          type:
            - string
            - 'null'
          description: Agenda numbering as published (e.g. `4`, `4.a`).
          example: 4.a
        item_title:
          type:
            - string
            - 'null'
          example: Approve minutes of the May 5 meeting
        item_description:
          type:
            - string
            - 'null'
          example: Staff recommends approval.
        children:
          type: array
          items:
            $ref: '#/components/schemas/AgendaItem'
          description: Child items, ordered; empty for leaf items.
      required:
        - item_number
        - item_title
        - item_description
        - children
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````