List a location's government bodies: 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 bodies updated since a specified time.
List locations: Returns a cursor-paginated list of the locations your API key is entitled to, ordered by last update (oldest first). 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.
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. Returns 404 if the meeting does not exist.
Get a meeting's transcript: 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 or your API key is not entitled to it.
List meetings: Returns a cursor-paginated list of the meetings under the locations your API key is entitled to, ordered by last update (oldest first). Page forward by passing the previous response's next_cursor as cursor. Pass updated_since to return only meetings changed at or after that time.
Health check: Returns the current status and version of the API.
Authentication: Authenticate every request with a Bearer API key scoped to your entitlements.
Errors: The error envelope and the stable set of codes your client should branch on.
Incremental sync: Pull only what changed since your last run with updated_since.
Hamlet API: Programmatic access to Hamlet civic intelligence data — government meetings, transcripts, and related records from local governments.
Pagination: Page through list endpoints with opaque cursors.
Quickstart: Make your first authenticated request to the Hamlet Public API in a few minutes.
Rate limits: Per-key rate limits, the headers that report your budget, and how to handle 429s.
Transcript format: How to fetch a meeting transcript and the structure of the JSONL artifact.