Skip to Content
Hey Town Hall Data docs
Decisions

API reference · Decisions

List motions

View as Markdown
GET
/v1/motions

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.

Authorization

bearerAuth
headerAuthorizationBearer <token>

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

Query Parameters

jurisdiction?string

A jurisdiction id.

Match^[a-z0-9][a-z0-9-]{0,63}$
region?string

A two-letter province or state code.

country?string

CA or US.

kind?string

A key decision's kind, such as bylaw_reading or contract_award.

Match^[a-z][a-z0-9_]{0,60}$
topic?string

A business topic id (GET /v1/topics lists the tags given).

Match^[a-z][a-z0-9_]{0,60}$
from?string

On or after this date (YYYY-MM-DD).

to?string

On or before this date (YYYY-MM-DD).

since?string

Records read at or after this instant: what is new since your last read.

meeting?string

A meeting id.

Match^[0-9]{1,18}$
limit?integer

Results a page, 1 to 100. Default 25.

cursor?string

next_cursor from the previous page.

Response Body

A page.

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/motions'
Example Response
{  "query": {    "property1": null,    "property2": null  },  "as_of": "string",  "results": [    {      "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"    }  ],  "next_cursor": "string",  "environment": "sandbox"}

Retrieve a motion GET

One motion with each member's recorded vote. Billed as one records request.

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.