# Hamlet API

## Docs

- [List a location's government bodies](https://www.myhamlet.com/docs/api-reference/government-bodies/list-a-locations-government-bodies.md): Returns a cursor-paginated list of the government bodies (city councils, planning commissions, …) for one location, ordered by last update (oldest first) so you can sync incrementally. Page forward by passing the previous response's `next_cursor` as `cursor`. Pass `updated_since` to return only bodi…
- [List locations](https://www.myhamlet.com/docs/api-reference/locations/list-locations.md): Returns a cursor-paginated list of the locations your API key is entitled to, ordered by last update (oldest first) so you can sync incrementally. Page forward by passing the previous response's `next_cursor` as `cursor`. Pass `updated_since` to return only locations changed at or after that time; i…
- [Get a meeting's agenda](https://www.myhamlet.com/docs/api-reference/meetings/get-a-meetings-agenda.md): 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, y…
- [Get a meeting's transcript](https://www.myhamlet.com/docs/api-reference/meetings/get-a-meetings-transcript.md): Returns metadata plus a short-lived (1-hour) presigned S3 URL to download the meeting's transcript as a JSONL file (one utterance per line, no embeddings). Returns 404 if the meeting does not exist, your API key is not entitled to it, or it has no built transcript artifact (`has_transcript` on the m…
- [List meetings](https://www.myhamlet.com/docs/api-reference/meetings/list-meetings.md): Returns a cursor-paginated list of the meetings under the locations your API key is entitled to, ordered by last update (oldest first) so you can sync incrementally. Page forward by passing the previous response's `next_cursor` as `cursor`. Pass `updated_since` to return only meetings changed at or…
- [Health check](https://www.myhamlet.com/docs/api-reference/system/health-check.md): Returns the current status and version of the API.
- [Authentication](https://www.myhamlet.com/docs/authentication.md): Authenticate every request with a Bearer API key scoped to your entitlements.
- [Errors](https://www.myhamlet.com/docs/errors.md): The error envelope and the stable set of codes your client should branch on.
- [Incremental sync](https://www.myhamlet.com/docs/incremental-sync.md): Pull only what changed since your last run with updated_since.
- [Hamlet API](https://www.myhamlet.com/docs/index.md): Programmatic access to Hamlet civic intelligence data — government meetings, transcripts, and related records from local governments.
- [Pagination](https://www.myhamlet.com/docs/pagination.md): Page through list endpoints with opaque cursors.
- [Quickstart](https://www.myhamlet.com/docs/quickstart.md): Make your first authenticated request to the Hamlet Public API in a few minutes.
- [Rate limits](https://www.myhamlet.com/docs/rate-limits.md): Per-key rate limits, the headers that report your budget, and how to handle 429s.
- [Transcript format](https://www.myhamlet.com/docs/transcript-format.md): How to fetch a meeting transcript and the structure of the JSONL artifact.

## OpenAPI Specs

- [openapi](https://www.myhamlet.com/docs/openapi.json)