| name | dc-elections |
| description | Query DemocracyClub EveryElection — the canonical list of every UK election (Westminster, devolved, mayoral, local, PCCs, parishes) with stable election IDs and the organisations / divisions they're held in. Use when the question is about which elections are scheduled or have happened on a date, or to look up the canonical id (e.g. `parl.2024-07-04`) for joining to other DC datasets. Pairs with dc-candidates. |
| license | Creative Commons Attribution-ShareAlike 4.0 (DemocracyClub) |
| metadata | {"facility":"dc-elections","cli-alias":"elections","base-url":"https://elections.democracyclub.org.uk/api","provenance":{"tier":3,"operator":"DemocracyClub","service":"elections.democracyclub.org.uk","upstream-data":"Election notices published by returning officers + DC's own additions for declared / scheduled future elections","citation-short":"via DemocracyClub EveryElection","citation-formal":"DemocracyClub EveryElection, retrieved {date}, CC BY-SA 4.0","confidence":"derived","confidence-notes":"Canonical for ID generation. Each election has provenance back to a returning-officer notice (PDF/HTML) where one exists."}} |
DemocracyClub EveryElection
Base URL: https://elections.democracyclub.org.uk/api/
Group codes
| Group | What |
|---|
parl | UK Parliament Westminster |
local | Local council |
mayor | Directly-elected mayor |
pcc | Police and Crime Commissioner |
sp | Scottish Parliament |
naw | Welsh Senedd (legacy slug) |
nia | NI Assembly |
gla | London Assembly |
parish | Parish / community council |
ref | Referendum |
CLI
parl elections list --group parl --date 2024-07-04
parl elections list --election-id parl.2024-07-04
parl elections get parl.holborn-and-st-pancras.2024-07-04
parl elections organisations --organisation-type local-authority
parl elections types
Join to dc-candidates
DC EveryElection ids are the keys used in dc-candidates ballots —
parl candidates ballots --election-id parl.2024-07-04 enumerates
the candidates of that election.
Provenance to cite
Tier 3 — third-party (DemocracyClub).
- Inline cite: "(via DemocracyClub EveryElection)" — once per
paragraph.
- For high-stakes statements about candidates / poll dates, prefer
the returning officer's notice (linked in each election's
notice_of_election field) over DC itself.
- See
../../docs/provenance.md.