Data Sources

Election Types and Subtypes

Valid Election types and subtypes are defined in the reference definition.

Organisation Names

For compatibility, organisation segments must use official names. Organisation names can be sourced from gov.uk registers. Short form versions of names should be used i.e: add an organisation segment with myid.with_organisation('Birmingham') not myid.with_organisation('Birmingham City Council')

• Local authorities in England: use the ‘name’ column/key

• Principal local authorities in Wales: use the ‘name’ column/key

• Local authorities in Scotland: use the ‘name’ column/key

• Local authorities in Northern Ireland

Alternatively organisation names can be sourced from the Every Election API. Use the common_name key.

Division Names

For compatibility, division segments must use official names. For boundaries that are already in use, names of parliamentary constituencies, district wards and county electoral divisions should be sourced from OS Boundary Line. New boundaries must be extracted from legislation. We also maintain a parser which can help with extracting this data from Electoral Change Orders.