Elections

  • This resource provides information about elections, including the election's unique ID, name, date, and political division.

  • Users can access details about specific elections by querying with available methods.

  • The resource also offers voter information based on registered address using the voterInfoQuery method.

  • Representations of the election data are provided in JSON format for easy integration.

A collection of information about elections and voter information.

For a list of methods for this resource, see the end of this page.

Resource representations

Information about the election that was queried.

{
  "id": long,
  "name": string,
  "electionDay": string,
  "ocdDivisionId": string
}
Property name Value Description Notes
electionDay string Day of the election in YYYY-MM-DD format.
id long The unique ID of this election.
name string A displayable name for the election.
ocdDivisionId string The political division of the election. Represented as an OCD Division ID. Voters within these political jurisdictions are covered by this election. This is typically a state such as ocd-division/country:us/state:ca or for the midterms or general election the entire US (i.e. ocd-division/country:us).

Methods

electionQuery
List of available elections to query.
voterInfoQuery
Looks up information relevant to a voter based on the voter's registered address.