API reference · Documents
Retrieve a bylaw
One bylaw. Billed as one records request.
bearerAuthAuthorizationBearer <token>htd_test_ (sandbox, free, fictional towns) or htd_live_ (live, billed) key.
id*string^[0-9]{1,18}$The record.
application/json- response
id*stringjurisdiction_id*stringcountry*string|nullregion*string|nullnumber*string|nulltitle*string|nullkind*string|nulladopted_on*|YYYY-MM-DD.
text_available*booleansubject*|The core subject its text regulates: zoning, building, animal_control, fire_burning, noise, trees, business_licence, fees_charges or other. Null: not yet read, or nothing says.
first_seen_at*|ISO 8601 instant, UTC.
source_url*|The page, document, video or platform the record was read from.
read_at*|When it was read.
environment*string"sandbox""live"curl -X GET 'https://data.heytownhall.com/v1/bylaws/string'{ "id": "string", "jurisdiction_id": "string", "country": "string", "region": "string", "number": "string", "title": "string", "kind": "string", "adopted_on": "string", "text_available": true, "subject": "string", "first_seen_at": "string", "source_url": "string", "read_at": "string", "environment": "sandbox"}List recorded votes GET
Each member's vote on a motion, as the minutes print it; never derived. A member away when the vote was taken is left out. Billed as one records request a page. Filters: jurisdiction, from, to, since, meeting, motion.
List bylaws GET
Bylaws by number, title, kind and adoption date. Billed as one records request a page. Filters: jurisdiction, region, country, kind, subject, from, to, since.