Democracy Club Menu

Election IDs

What are election IDs?

Election IDs are unique identifiers for any state-run election in the UK.

Why do we need election IDs?

In order to build tools around elections, Democracy Club has found a really basic problem: naming them! It's easy when you're handling just, for example, a General Election, but if you're making a site that has to handle hundreds of different local elections and regional elections, we need a standard way to refer to them. This then allows datasets, such as upcoming elections, candidates, polling stations, leaflets, or news mentions, to be joined up to serve the needs of voters.

How are they defined?

You can read the reference definition here.

Where are Election IDs used?

We create election ids using our Every Election platform and consume them in our public-facing projects. Elections are referenced using these identifiers in our Candidate data.

How can I create an election ID?

You can create election IDs interactively using our Every Election platform.

If you need to generate election identifiers in your software, we supply a python package.

You can derive election IDs using the reference.