# Hamlet API

- [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.
- [Quickstart](https://www.myhamlet.com/docs/quickstart.md): Make your first authenticated request to the Hamlet Public API in a few minutes.
- [Authentication](https://www.myhamlet.com/docs/authentication.md): Authenticate every request with a Bearer API key scoped to your entitlements.
- [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.
- [Pagination](https://www.myhamlet.com/docs/pagination.md): Page through list endpoints with opaque cursors.
- [Incremental sync](https://www.myhamlet.com/docs/incremental-sync.md): Pull only what changed since your last run with updated_since.
- [Transcript format](https://www.myhamlet.com/docs/transcript-format.md): How to fetch a meeting transcript and the structure of the JSONL artifact.
- [Errors](https://www.myhamlet.com/docs/errors.md): The error envelope and the stable set of codes your client should branch on.
- [Health check](https://www.myhamlet.com/docs/api-reference/system/health-check.md): Returns the current status and version of the API.
- [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…
- [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 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…
- [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…

## OpenAPI Specs

- [openapi](/docs/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.