Skip to Content
Hey Town Hall Data docs
Meetings

API reference · Meetings

A meeting's transcript

View as Markdown
GET
/v1/meetings/{id}/transcript

The meeting's recordings' transcript lines in order, without speaker labels. Billed as one transcripts request a page. An empty page means no transcript is held yet, never that nothing was said.

Authorization

bearerAuth
headerAuthorizationBearer <token>

htd_test_ (sandbox, free, fictional towns) or htd_live_ (live, billed) key.

Path Parameters

id*string
Match^[0-9]{1,18}$

Query Parameters

limit?integer

Lines a page, 1 to 100. Default 100.

cursor?string

next_cursor from the previous page.

Response Body

A page of lines.

application/json
  1. response
query*

The filters as the API read them, defaults included.

as_of*string

ISO 8601 instant, UTC.

results*array<>
next_cursor*|

Pass as cursor for the next page; null on the last.

environment*string

sandbox answers carry fictional towns.

Value in"sandbox""live"
Example Request
curl -X GET 'https://data.heytownhall.com/v1/meetings/string/transcript'
Example Response
{  "query": {    "property1": null,    "property2": null  },  "as_of": "string",  "results": [    {      "id": "string",      "recording_id": "string",      "start_ms": 0,      "end_ms": 0,      "text": "string",      "source_url": "string",      "read_at": "string"    }  ],  "next_cursor": "string",  "environment": "sandbox"}

List meeting documents GET

Agenda packages, minutes and attachments a meeting lists, with their links. Billed as one records request a page. Filters: jurisdiction, region, country, kind, from, to, since, meeting.

Retrieve a meeting GET

One meeting with its agenda items, documents, recordings and motions. Billed as one records request.