- Actions: the steps in the bill’s history, such as readings and stages.
- Events: sittings, debates, and other activities on the bill, past and scheduled.
- Amendments: amendments tabled to the bill, with their text and sponsors.
- Votes: divisions (counted votes) and decisions on amendments.
- Speeches: contributions to debates on the bill, with their text.
- Text versions: each published version of the bill, with its full text.
Base URL
All legislative endpoints are relative to:https://parsagon.io/api/events/v1/.
Authentication
Authenticate with your API key, the same way as for every other endpoint. See Authentication.Access
Legislative data is enabled per jurisdiction. To get access, contact us at webmaster@parsagon.io. To see which jurisdictions your API key can read, call List jurisdictions.- Your account needs a valid Parsagon subscription and must have accepted the Terms of Service. Otherwise, every endpoint returns
403 Forbidden. - A bill in a jurisdiction you can’t access returns
404 Not Found, as if it didn’t exist. The same applies to its records. - A new bill appears once Parsagon finishes collecting it for the first time.
Identifiers
- Bills and their records are identified by
id, a UUID. Records keep the sameideach time Parsagon updates them. - Jurisdictions are identified by
code, such as"GB". external_idis the ID of a bill or record in the legislature’s own system.- Sources are identified by their
uuid, the same as in search and category sources results.
Dates and times
All dates and times are in ISO 8601 format (UTC). Date filters such asupdated_since also take ISO 8601, for example 2026-11-01T00:00:00Z.
Language
current_stage and other text from the legislature are in the legislature’s own language. Actions also have an English text, with the original wording in source_language_text.
Pagination
List bills uses cursor pagination:- Set the page size with
page_size(default100, maximum500). - Follow the
nextURL in each response until it isnull.
- Set the page size with
limit(default100, maximum500) and skip records withoffset. - Each response includes
count, the total number of matching records.
Polling for changes
To catch new bills and new activity on existing bills:- Call List bills with
updated_sinceset to the start of your previous poll, minus a margin such as 1 hour. Follownextuntil it isnull. - For each bill returned, retrieve the records you need, such as votes or speeches. Compare record
ids with the ones you already have to find new records.
updated_since filters on when Parsagon collected a change, not when the legislature made it. A change that the legislature dated earlier but Parsagon collected later is still returned.
From a source to its bill
Search and category sources results include sources of type"LEGISLATION". Each of these is a bill text version, amendment, speech, or division from the bill tracker. To find the bill and the record a source belongs to, pass its uuid to Get legislative source.