Skip to main content
The PolicyMate API gives your system direct access to the legislative and regulatory record PolicyMate maintains. That includes bills and their milestones, documents published by agencies and local governments, the people and organisations those documents name, and the recommendations PolicyMate makes for your workspaces. If you can see it in PolicyMate, you can retrieve it through the API. The API is a JSON REST API. Requests are authenticated using API keys, lists are paginated using cursors, and every endpoint behaves the same way whether a record comes from a national parliament, a state legislature, or a city council.
The API is currently in beta and versioned as v0. During the beta, field names and response shapes may still change, and we will notify API users before any change ships.

​
How It Works

Every record in PolicyMate belongs to a jurisdiction, and records are linked to one another. Let’s take a quick look at how the pieces fit together: Diagram of the API resources: a jurisdiction holds bills and documents, mentions connect documents to the bills, people, and organisations they name, and recommendations come from your workspace Bills come from legislatures, while documents come from agencies, regulators, and local governments. Mentions connect the two: when a document names a bill, a person, or an organisation, PolicyMate records the mention along with the exact quote. Recommendations sit on top of everything, representing PolicyMate’s judgement of which records matter to each of your workspaces.

Authentication

Create an API key and make your first request.

Bills

Search bills, follow their milestones, and read their texts.

Documents

Retrieve notices, agendas, and minutes from agencies and local governments.

Webhooks

Get notified the moment something changes.