API reference · Decisions
Retrieve a motion
One motion with each member's recorded vote. 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*stringmeeting_id*stringjurisdiction_id*stringcountry*string|nullregion*string|nullmeeting_date*stringYYYY-MM-DD.
position*numberitem_position*number|nullnumber*string|nulltext*stringmover*string|nullseconder*string|nulloutcome*|carried, defeated, tabled, referred, withdrawn — as printed, normalised.
unanimous*boolean|nullvotes_for*number|nullvotes_against*number|nullkinds*array<string>topics*array<string>actions*array<string>business_topics*array<string>source_url*|The page, document, video or platform the record was read from.
read_at*|When it was read.
votes*array<>environment*string"sandbox""live"curl -X GET 'https://data.heytownhall.com/v1/motions/string'{ "id": "string", "meeting_id": "string", "jurisdiction_id": "string", "country": "string", "region": "string", "meeting_date": "string", "position": 0, "item_position": 0, "number": "string", "text": "string", "mover": "string", "seconder": "string", "outcome": "string", "unanimous": true, "votes_for": 0, "votes_against": 0, "kinds": [ "string" ], "topics": [ "string" ], "actions": [ "string" ], "business_topics": [ "string" ], "source_url": "string", "read_at": "string", "votes": [ { "member_name": "string", "vote": "string" } ], "environment": "sandbox"}List attendance GET
Who the minutes say was present or absent at a meeting. Billed as one records request a page. Filters: jurisdiction, from, to, since, meeting.
List motions GET
Motions as the minutes print them: mover, seconder, outcome and the count of votes, with each key decision's kind, topic and action. Billed as one records request a page. Filters: jurisdiction, region, country, kind, topic, from, to, since, meeting.