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).
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 six values (“primary”, “primary run-off”, “general”, or “general run-off”, "convention", "convention run-off") indicating which stage a given election’s contests were at. |
jurisdiction state | The state (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,” “incorporated place”, and "local education agency." 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 (all caps). |
democratic candidates only | A boolean (true/false) indicating whether the election is only for Democratic Party candidates (such as in a partisan primary election). |
republican candidates only | A boolean (true/false) indicating whether the election is only for Republican Party candidates (such as in a partisan primary election). |
is top two | A boolean (true/false) 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 (true/false) 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 (true/false) 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 (true/false) 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 (true/false) 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 (true/false) 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. |
[
{
"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
}
]
Last modified 1mo ago