Electoral Commission

Electoral Commission / Democracy Club

Access to UK election data via the Democracy Club APIs and the Parliament Linked Data API. No authentication required.

Data Sources

• Democracy Club Elections API — Full database of UK elections (local, parliamentary, mayoral, PCC, etc.) with metadata, dates, and organisation info.
• Democracy Club Candidates API — Ballot-level data including candidates, wards/constituencies, and results.
• Parliament Election Results API — Historical UK parliamentary election results with candidate vote counts, majorities, turnout, and electorate size.

Data Model

• Election — A scheduled election event with an election_id (e.g. "local.2023-04-20"), type, date, and children (sub-elections).
• Ballot — A specific ballot paper for a ward/constituency within an election. Contains candidates, winner count, voting system.
• Election Result — Parliamentary result for a constituency with candidate vote totals, majority, turnout, and electorate.

Key Fields

• election_id — Unique election identifier (e.g. "parl.2024-07-04", "local.hackney.2022-05-05")
• poll_open_date — Date of the election
• election_type — Type: local, parl (parliamentary), mayor, pcc, senedd, sp, etc.
• ballot_paper_id — Unique ballot identifier within an election
• resultOfElection — Text summary (e.g. "Lab Hold", "Con Gain from Lab")

Gotchas

• Democracy Club pagination uses limit and offset parameters.
• Parliament LDA API uses _pageSize and _page parameters (0-indexed pages).
• Election IDs follow a hierarchical dot notation: type.org.ward.date.
• The current boolean on elections indicates whether it's an upcoming/active election.