Skip to main content
GET
/
v1
/
meetings
List meetings
curl --request GET \
  --url https://api.myhamlet.com/v1/meetings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "uuid": "0b3d5f2e-1c4a-4e8b-9f6d-2a1c3e4b5d6f",
      "location_uuid": "5f2b0c3a-1d4e-4a8b-9f6d-2a1c3e4b5d6f",
      "location_name": "Oakland",
      "government_body_uuid": "c30d2f7e-9a1b-4c5d-8e6f-0a1b2c3d4e5f",
      "government_body_name": "City Council",
      "type": "REGULAR",
      "date": "2026-05-20",
      "ordinal": 1,
      "is_cancelled": false,
      "has_agenda": true,
      "has_transcript": true,
      "created_at": "2026-05-21T02:00:00.000Z",
      "updated_at": "2026-05-22T09:14:00.000Z"
    }
  ],
  "next_cursor": "eyJ1IjoiMjAyNi0wNS0wMSAxODoyMjoxMCIsImkiOjQyfQ"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
per_page
integer
default:50

Maximum number of items to return per page.

Required range: 1 <= x <= 100
Example:

50

​
cursor
string

Opaque pagination cursor from a previous response's next_cursor. Omit for the first page.

Example:

"eyJ1IjoiMjAyNi0wNS0wMSAxODoyMjoxMCIsImkiOjQyfQ"

​
updated_since
string<date-time>

Inclusive lower bound on updated_at (ISO-8601 with a UTC Z or numeric offset, e.g. 2026-05-01T18:22:10Z). Returns only records changed at or after this time, ordered and paged exactly like a normal request — pass it alongside cursor to sync incrementally. A malformed or offset-less timestamp returns 400.

Example:

"2026-05-01T18:22:10Z"

​
government_body_uuid
string<uuid>

Restrict the list to meetings of this government body. The body must be under one of your entitled locations; an unknown or un-entitled uuid returns 404.

Example:

"c30d2f7e-9a1b-4c5d-8e6f-0a1b2c3d4e5f"

Response

A page of meetings.

​
data
object[]
required
​
next_cursor
string | null
required

Pass as cursor to fetch the next page; null when there are no more results.

Example:

"eyJ1IjoiMjAyNi0wNS0wMSAxODoyMjoxMCIsImkiOjQyfQ"