election
This table includes one record per election -- which we define as a time-specific opportunity for a group of registered voters in a given jurisdiction to cast a ballot for one or more offices that share an election type, stage, and voting method.For example, on November 3, 2020, there were 69 elections administered at the state-level: 51 standard general elections, 1 standard top two primary (for state and federal offices in Louisiana), and 17 special elections (including the top-two special primary for the U.S. Senate in Georgia).

Schema

Field
Description
election id
Unique ID maintained by Deck representing a specific election. We define an election as an opportunity for registered voters in a given jurisdiction to cast a ballot for one or more offices.
year
The year a given election took place.
date
The final date (or only date) of voting for a given election.
type
If a given election was held at a regularly scheduled interval, it is “standard.” If it was held outside of a regular schedule to fill an unexpected vacancy, it is “special.” Elections with unknown types have a null value.
stage
One of four values (“primary”, “primary run-off”, “general”, or “general run-off”) indicating which stage a given election’s contests were at.
jurisdiction state
The state (in the form of a two-letter abbreviation) that the district’s jurisdiction is associated with.
jurisdiction type
The type of jurisdiction this district is associated with. Possible values are “state,” “county,” and “incorporated place.” Districts can also be associated with local education agencies, but those are currently outside the scope of Hubble.
jurisdiction name
The name of the jurisdiction associated with a given district.
democratic candidates only
A boolean indicating whether the election is only for Democratic Party candidates (such as in a partisan primary election).
republican candidates only
A boolean indicating whether the election is only for Republican Party candidates (such as in a partisan primary election).
is top two
A boolean indicating whether the election is in the context of a “top two” (a.k.a. “nonpartisan blanket primary”) system rather than a standard partisan primary system.
is ranked choice
A boolean indicating whether the election is in the context of a “ranked choice” (a.k.a. “instant run-off”) system rather than a "first-past-the-post" system.
open to all voters
A boolean indicating whether all registered voters can participate in a given election. This should be “true” for general elections, top two elections of all kinds, and open primaries.
open to democratic voters
A boolean indicating whether voters registered as Democrats can participate in a given election. This should be “false” in closed primaries and semi-closed primaries for the Republican Party.
open to republican voters
A boolean indicating whether voters registered as Democrats can participate in a given election. This should be “false” in closed primaries and semi-closed primaries for the Democratic Party.
open to unaffiliated voters
A boolean indicating whether voters registered as Democrats can participate in a given election. This should be “false” in closed primaries for the Democratic and Republican Parties.

Example entry

[
{
"election_id": "34981393-133f-41a5-8786-ef5ad535fa1e",
"year": "2012",
"date": "2012-11-06",
"type": "standard",
"stage": "general",
"jurisdiction_state": "AK",
"jurisdiction_type": "state",
"jurisdiction_name": "AK",
"is_top_two": false,
"is_ranked_choice": false,
"open_to_all_voters": true,
"open_to_democratic_voters": true,
"open_to_republican_voters": true,
"open_to_unaffiliated_voters": true
}
]
Export as PDF
Copy link
On this page
Schema
Example entry