Local government data for AI and API

City hall’s filing cabinet, open to your software.

Councils, counties and school boards file far more than meetings. Bylaws, budgets, bids, permits, staff, notices. We read all of it, keep it in order and hand you one key.

Sign-ups open soon Open your dashboard Read the docs

Drawer 3 · Money · folder: bids

Open it and the record is already typed up.

Each card says what it is, where it came from and when we last read it. Nothing arrives without its source.

SANDBOX RECORD 100009City of Port Ellery · Marlow County

ITT 2026-06: Snow clearing services 2026-2028

published_at ...... 2026-10-11

closes_at ......... 2026-11-21

categories ........ procurement

jurisdiction_id ... port-ellery

source_url bids.example/port-ellery/100009 · read_at 2026-10-30T16:00Z

Seven drawers

The point is the breadth. One dataset holds everything a government publishes, filed by family, so you query across all of it with the same key.

1 · Meetings
Meetings, agendas, minutes, motions and transcripts.
Record kinds in this drawer
- meetings
- agenda items
- meeting documents
- motions
- votes
- attendance
- recordings
- transcripts
The Meetings drawer in the docs
2 · Laws
Bylaws, zoning rules and official plans, full text.
Record kinds in this drawer
- bylaws
- defined terms
- documents
The Laws drawer in the docs
3 · Money
Budgets, financial statement lines, fees, bids and tenders.
Record kinds in this drawer
- budgets
- financial reports
- financial lines
- fees
- bids
The Money drawer in the docs
4 · Development
Development applications, permit rules, road and utility works.
Record kinds in this drawer
- applications
- permits
- works
The Development drawer in the docs
5 · People
Elected officials, departments and job postings.
Record kinds in this drawer
- officials
- council appointments
- departments
- jobs
The People drawer in the docs
6 · Places
Jurisdictions, boundaries and the software each government runs.
Record kinds in this drawer
- jurisdictions
- platforms
- platform tenants
The Places drawer in the docs
7 · Public word
News releases, notices and events.
Record kinds in this drawer
- news
- engagements
- press
The Public word drawer in the docs

Every row carries source_url and read_at. Coverage today is British Columbia. The United States is being added.

Two ways to pull a card

Connect the AI model your company already uses through our hosted MCP server, or call the REST API from your own code. Both take the same key and read the same drawers.

For your AI model

MCP

Add one address as a connector and your model can look things up and cite the source.

data.heytownhall.com/mcp

ask    Which tenders are open
       in Port Ellery?
call   list_bids  jurisdiction=port-ellery
found  ITT 2026-06: Snow clearing services 2026-2028
       closes 2026-11-21
       source_url bids.example/port-ellery/100009

For your software

REST API

Plain JSON over HTTPS, paged by cursor. Same records, same fields.

data.heytownhall.com/v1

GET /v1/bids?jurisdiction=port-ellery
Authorization: Bearer htd_test_...

{ "results": [{ "id": "100009",
    "title": "ITT 2026-06: Snow clearing services 2026-2028",
    "closes_at": "2026-11-21T22:00:00.000Z",
    "source_url": "https://bids.example/port-ellery/100009",
    "read_at": "2026-10-30T16:00:00.000Z" },
    …],
  "next_cursor": null,
  "environment": "sandbox" }

Flat rates. The same at any volume.

Records, search and transcripts each have one rate per 1,000 requests, the same at any volume. No tiers, no volume discounts. You set a monthly cap, and failed requests are never billed.

Rate cardDraft rates, not final

Sandbox key, htd_test_: Free
Live key, records: $2.00 per 1,000 requests (draft)
Live key, search: $6.00 per 1,000 requests (draft)
Live key, transcripts: $10.00 per 1,000 requests (draft)
Monthly cap: You set it
Failed requests: Never billed
Volume discounts: None

City hall’s filing cabinet, open to your software.

Seven drawers

1 · Meetings

2 · Laws

3 · Money

4 · Development

5 · People

6 · Places

7 · Public word

Two ways to pull a card

For your AI model

For your software

Flat rates. The same at any volume.

Library card application