Data downloads and API
Everything on the site can be downloaded as CSV (for spreadsheets) or JSON, and the same endpoints form a free, read-only public API. Downloads from the leaderboard, records and party pages keep the filters you chose.
Data contains Parliamentary information licensed under the Open Government Licence v3.0, from Northern Ireland Assembly Open Data. Classifications are AI-generated assessments, not facts; please say so if you republish them, and link back to the record so readers can check the assessment.
| Endpoint | Description |
|---|---|
/api/v1/leaderboard.csv | Current-MLA leaderboard. Accepts the leaderboard filters and sort. |
/api/v1/leaderboard.json | The same, as JSON, with the scope used. |
/api/v1/records.csv | Every record matching the filters (up to 100,000 rows), with its classification. |
/api/v1/records.json | The same, as JSON. |
/api/v1/records/123.json | One record with its full assessment history and review history (replace 123 with a record number). |
/api/v1/members.csv | MLAs with membership and party periods. |
/api/v1/members.json | The same, as JSON. |
/api/v1/parties.csv | Party comparison figures. Accepts the comparison filters. |
/api/v1/parties.json | The same, as JSON. |
/api/v1/divisions.csv | Every division with totals and result. |
/api/v1/divisions.json | The same, as JSON. |
/api/v1/votes.csv | Every individual vote. Add ?division=ID or ?mla=slug to narrow it. |
/api/v1/votes.json | The same, as JSON. |
/api/v1/rubric.json | The classification rubric: questions, options, thresholds and versions. |
/api/v1/status.json | Processing coverage and the time of the last successful update. |
Filters
Record, leaderboard and party endpoints accept these query parameters:
type– activity type, repeatable:written_question,oral_question,topical_question,urgent_question,motion,other_business,member_statement,speechfrom,to– dates as YYYY-MM-DDparty,mla– slugs as used in page addresses;constituency– full nameoutcome–qualifying,not_qualifying,uncertain,pending,failedorexcluded(records only)category,criterion– see the rubric for valuescapacity–memberorministerq– full-text search (records only)sort–qualifying,rate,percentage,analysedorname(leaderboard only)
Responses can be used from other websites (they send Access-Control-Allow-Origin: *) and are cached for up to 10 minutes. Please be considerate with automated requests.