Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
The quilt of American democracy is highly varied and complex. Ballotpedia strives to create an intuitive data structure to serve the variety of elections across the country, but it still requires some special terminology and a few unique data structures. This site includes information about API syntax, key concepts, data dictionaries, and some details about common edge cases.
Navigate to either Geographic APIs or Bulk Data depending on your use case to learn more.
If you have any questions, please feel free to reach out to your Ballotpedia sales contact.
Redistricting is the act of redrawing a voting district's boundaries. 2020 was the last major redistricting cycle.
Ballotpedia tracks which voting district boundary is in effect at a given time using start dates and end dates. The start date corresponds to the date when an officeholder swears into office, and the end date is the officeholder's last day in office.
A voting district boundary's start and end dates do not necessarily, and usually do not, equal the election date for that office. Ballotpedia determines which voting district will be used for which race based on several factors, including the voting boundary's start and end dates; the race year; the election date; the race's swearing in date; and whether the race is a regular or special election.
As an example, California's 22nd Congressional district has voting district boundaries with the following end dates.
Pre-2020 redistricting boundary end date: 2023-01-02
Post-2020 redistricting boundary end date: null (implying it will be used for the foreseeable future)
In 2022, California's 22nd Congressional district had a special election and regular election on the same date. How did we know which boundary would be used for each race?
For the 2022 special election, we knew that the pre-redistricting voting boundary was used, because
It was a special election
The election date was before the boundary's end date
For the 2022 regular election, we knew that the post-redistricting voting boundary was used, because the race's swearing in date was after the pre-redistricting boundary's end date.
Ballotpedia content is copyrighted by Ballotpedia's editors and contributors. Licensed data sets are the proprietary and confidential property of Ballotpedia.
Licensee shall take all reasonable precautions to preserve the confidentiality of Licensor's Software and Data and shall assume responsibility that its employees and assignees will similarly preserve this information against third parties.
No right or license is being conveyed to Licensee to use or share the full data sets provided by Ballotpedia with any other company or individual. Data may be used in Licensee’s internal or external products as long as precautions are taken to protect Ballotpedia’s assets by preventing bulk downloads of the data set by third parties.
The purchase of Ballotpedia data by Licensee constitutes acceptance of these terms.
Ballotpedia’s bulk data clients can access their data on-demand with our client portal at https://clients.ballotpedia.org/. The data is refreshed every 24 hours. You may access your data through two methods, as described below:
Login with provided password and click to download latest file (detailed below)
Access latest data file via API (for technical users, see: Downloading data via API)
Login to the dashboard at with the provided email and password.
Upon logging in, you’ll see a list of your available queries with the title and description.
For each query, there are two available formats, JSON and CSV. Clicking on either of these buttons will begin the download process for the respective format.
Please contact Ballotpedia’s data sales team to request password changes.
This API is rate-limited using the token bucket algorithm.
Rate: 5 requests per second
The 5 requests per second applies to how many requests can be initiated each second; the requests do not need to finish before more can be started at the 5 request per second rate.
Burst Capacity: 100 requests
The burst capacity enables your application to temporarily exceed the 5 RPS limit by using pre-accumulated tokens. This allows for short spikes in traffic to be handled smoothly without triggering throttling, as long as tokens remain available in the burst bucket.
If you send fewer than 5 requests in a given second, burst tokens accumulate (up to 100), allowing for additional bursts in traffic.
Total Daily Quota: 200k requests
The total number of requests allowed in a 24 hour period.
If the request rate is exceeded, a response with HTTP 429 Too Many Requests is sent.
To avoid throttling:
Keep steady usage at or below 5 requests per second.
Implement exponential backoff with retry logic to space out retries.
If your application requires a higher sustained rate, burst capacity, or daily quota, please contact us.
Election dates by point or by state
Given a latitude and longitude point, a list of election dates will be returned for the particular point (address) that have occurred 1 year in the past and will occur 1 year in the future according to today's date.
Required parameters: lat, long
Optional parameters: none
Election dates can be queried via several parameters which will return data from 2018+ and several years into the future. Data is returned in an ascending matter according to date, with limits of 25 results per page.
Required parameters: none
Optional parameters:
state={state abbreviation}
type=General,Primary,Special,Recall
year={year}
page={number}
Example call querying for all Special Elections that occurred in Wisconsin in 2020.
https://api4.ballotpedia.org/data/election_dates/point?lat=40.5550746&long=-74.27596989999999{
"success": true,
"data": {
"elections": [
{
"type": "General",
"id": 18742,
"date": "2020-11-03",
"description": null
},
{
"type": "General",
"id": 18775,
"date": "2020-11-03",
"description": "U.S. Presidential election"
},
{
"type": "General",
"id": 22516,
"date": "2021-11-02",
"description": null
}
]
},
"message": null
}https://api4.ballotpedia.org/data/election_dates/list {
"success": true,
"data": {
"elections": [
{
"date": "2018-01-02",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "SC"
},
{
"date": "2018-01-02",
"type": "Recall",
"description": "https://ballotpedia.org/Andrew_Hamilton_recall,_Lake_Forest,_Ca",
"candidate_lists_complete": true,
"state": "CA"
},
{
"date": "2018-01-09",
"type": "Recall",
"description": "https://ballotpedia.org/Larry_Thomas_recall,_Washburn_City_Comm",
"candidate_lists_complete": true,
"state": "ND"
},
{
"date": "2018-01-09",
"type": "Primary",
"description": "Special primary election",
"candidate_lists_complete": true,
"state": "NH"
},
{
"date": "2018-01-09",
"type": "General",
"description": "General election",
"candidate_lists_complete": true,
"state": "GA"
},
{
"date": "2018-01-09",
"type": "General",
"description": "General election",
"candidate_lists_complete": true,
"state": "GA"
},
{
"date": "2018-01-09",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "CT"
},
{
"date": "2018-01-09",
"type": "Primary",
"description": "Special primary election",
"candidate_lists_complete": true,
"state": "OK"
},
{
"date": "2018-01-09",
"type": "General Runoff",
"description": "Special election runoff for State Senate District 49",
"candidate_lists_complete": true,
"state": "MS"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "SC"
},
{
"date": "2018-01-16",
"type": "Recall",
"description": "https://ballotpedia.org/Mayor_and_town_board_recall,_Rockvale,_",
"candidate_lists_complete": true,
"state": "CO"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "WI"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "WI"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "WI"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "SC"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "SC"
},
{
"date": "2018-01-16",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "IA"
},
{
"date": "2018-01-23",
"type": "Special",
"description": null,
"candidate_lists_complete": true,
"state": "OR"
},
{
"date": "2018-01-23",
"type": "General",
"description": "Special election",
"candidate_lists_complete": true,
"state": "PA"
},
{
"date": "2018-01-23",
"type": "General",
"description": "Local ballot measures",
"candidate_lists_complete": true,
"state": "CA"
},
{
"date": "2018-01-23",
"type": "Recall",
"description": "https://ballotpedia.org/Francisco_Ramirez_recall,_Hanford_City_",
"candidate_lists_complete": true,
"state": "CA"
},
{
"date": "2018-01-25",
"type": "Primary",
"description": "Primary election",
"candidate_lists_complete": true,
"state": "TN"
},
{
"date": "2018-01-29",
"type": "Primary",
"description": "Special primary election",
"candidate_lists_complete": true,
"state": "MN"
},
{
"date": "2018-01-29",
"type": "Primary",
"description": "Special primary election",
"candidate_lists_complete": true,
"state": "MN"
},
{
"date": "2018-01-30",
"type": "Primary",
"description": "Special primary election",
"candidate_lists_complete": true,
"state": "FL"
}
]
},
"message": null
}https://api4.ballotpedia.org/data/election_dates/list?state=WI&type=Special&year=2020&page=1{
"success": true,
"data": {
"elections": [
{
"date": "2020-05-12",
"type": "Special",
"description": "Special election to fill unexpired term",
"candidate_lists_complete": false,
"state": "WI"
}
]
},
"message": null
}The officeholders data set includes current, elected officeholders for Congress, statewide positions, state legislative positions, as well as elected officials in the top 100 cities by population.
Contact information is optional, available for an additional charge.
Values are listed below. The "officeholder" contact is the one used in an official capacity, while "personal" represents contacts or accounts that may not relate to the person's current position.
Values:
officeholder_email
other_email
officeholder_website
personal_website
This document lists data points collected by Ballotpedia related to vote by mail and in-person voting for statewide elections. Ballotpedia defines statewide elections as elections meeting the following criteria: all voters in the state can participate, and all offices or measures up for election are at either the state or federal level.
Data points are per-election, which may include statewide primaries, major party presidential preference primaries, general elections, and any applicable runoffs.
Depending on your subscription, you may see local election dates included with these basic attributes, but without the voting rules data provided for statewide elections (vote in person or vote by mail rules).
election_date
state
district_type
election_type
election_description
vote_by_mail:_in-person_request_deadline
vote_by_mail:_online_request_deadline
vote_by_mail:_mail_request_deadline
vote_by_mail:_mail_request_deadline_type
types_of_voter_id_accepted
required_materials_url_english
required_materials_url_spanish
voter_id_required_for_all
In-person deadline
Mail deadline
Mail registration deadline type
Online deadline
Early voting start date
Early voting end date
Poll times
Voting location URL English
Voting location URL Spanish
Voter info URL English
vote_by_mail:_mail_return_deadline
vote_by_mail:_mail_return_deadline_type
voter_id_source_spanish
required_materials
Registration status URL English
Registration status URL Spanish
Registration update URL English
Registration update URL Spanish
Register online URL English
Register online URL Spanish
district_name
Name of district (geographical area) that elects the office.
district_type
Type of district that elects the office:
-Country
-State
-Congress
-State Legislative (Upper)
-State Legislative (Lower)
-County
-School District
-City-town
-Judicial District
-Special District
-State subdivision
-County subdivision
-Judicial district subdivision
parent_district_id
Ballotpedia unique identifier used to associate a "subdivision" district with its parent (not comprehensive). Example: "X City Council, District 1" and "X City Council, District 2" have a parent district of "X City".
parent_district_name
Name of parent district
gender
One of the following, or NULL:
-Male
-Female
-Neither/Both (if the person explicitly identifies as neither or both of the above)
status
Describes the status of the officeholder. One of the following:
-Current
-Acting
-Elect
-Magistrate
-Senior
party_affiliation
Primarily for officeholders elected in partisan elections, this is the political party with which they are/were affiliated.
date_assumed_office
Date on which they assumed this office (swearing in date or similar)
appointed_by
If relevant, the name of the person who appointed this officeholder to this office (such as a Governor)
date_appointed
Date of the appointment
date_confirmed
Date of the confirmation (judicial)
date_term_ends
For former or outgoing officeholders, the date on which they left or will leave office
personal_facebook
officeholder_x
personal_x
officeholder_tiktok
personal_tiktok
officeholder_instagram
personal_instagram
officeholder_youtube
personal_youtube
officeholder_mailing_address
officeholder_phone
state
The state in which the office has jurisdiction (postal abbreviation)
office_id
Ballotpedia unique identifier (stable across officeholders)
office_name
Name of the office
office_level
Level of government:
-Federal
-State
-Local
office_branch
Branch of government:
-Executive
-Legislative
-Judicial
district_id
Ballotpedia unique identifier
district_ocdid
officeholder_id
Ballotpedia unique identifier
person_id
Ballotpedia unique identifier (stable across time or offices held)
name
Full name of the officeholder
first_name
First name of the officeholder
last_name
Last name of the officeholder
url
Link to the Ballotpedia profile about this person
The project seeks to assign somewhat predictable and globally unique identifiers to political divisions. This field is not uniformly filled due to data availability.
Ballotpedia’s bulk data clients can access their data on-demand with our client portal at https://clients.ballotpedia.org/. The data is refreshed every 24 hours. You may access your data through two methods, as described below:
Login with provided password and click to download latest file (for non-technical users)
Access latest data file via API (for technical users, see next page)
The API can be called directly by interacting with two endpoints. Please note that these endpoints can only be accessed from a non-CORS context.
This endpoint will return an array of objects, each object represents a data set and contains the ID, Title and Description.
The endpoint requires your API Key passed in as a header:
Example response with a single file:
This endpoint will return a URL to the requested file:
The endpoint requires your API Key passed in the header as described above, the content type of application/json, and the ID (obtained from the getQueryList endpoint) of the data set and the format passed via the body in the POST request.
Headers
Body
To get the data to return in csv format, make the same call as for json data but change the format parameter from json to csv.
Example Response:
The URL for the downloadable file expires after 5 minutes. The URL returned should change with each call to getQueryResults. Files are re-generated daily, and the URL will always return only the last generated file.
This guide is intended for prospective and current API customers of Ballotpedia. We want to make it easy for you to understand and use the data we provide in our API; this document gives concrete examples for some real-world applications you might want to build using the API.
Suppose you want to provide a sample ballot lookup on your website. This can be accomplished by the following steps:
Find the user's location. Ultimately, you’ll need the latitude/longitude coordinates corresponding to the user’s location. This can be accomplished by asking the user to input their address, and using something like Google’s Geocoding API or the AWS Location service to convert that address to latitude/longitude coordinates.
With the user's lat/long, query the /election_dates endpoint.
With the user's lat/long and chosen election date, pass these parameters to the /elections_by_point endpoint.
Finally, display the results. Exactly how to do this is up to you, but now you have all the data you need to do it. You can loop over the districts, races, and candidates and display their names, party affiliations, link to their Ballotpedia profile, status, and much more.
Suppose you want to allow users to look up their current elected officials. This can be accomplished by the following steps:
Find the user's location. Ultimately, you’ll need the latitude/longitude coordinates corresponding to the user’s location. This can be accomplished by asking the user to input their address, and using something like Google’s Geocoding API or the AWS Location service to convert that address to latitude/longitude coordinates.
Fetch the elected officials for the user’s location. Supply the latitude/longitude coordinates from the previous step into the /officeholders endpoint.
Display the results. This part is up to you, but now you have all the data you need to do it. You can loop over the districts, offices, and officeholders and display their names, party affiliations, link to their Ballotpedia profile, contact information, and much more.
Voting districts endpoint
Given a latitude and longitude point, a list of voting districts will be returned in which that point (address) lies.
By default, the returned voting districts are in effect on the current date. An optional date parameter can be provided, which will show the districts which are/were in effect on that date. See the section for more details.
Required parameters: lat, long
Optional parameters: date
-City-town subdivision
-School district subdivision
The state in which the office has jurisdiction (postal abbreviation)
office_id
Ballotpedia unique identifier (stable across election years)
office_name
Name of the office
office_level
Level of government:
-Federal
-State
-Local
office_branch
Branch of government:
-Executive
-Legislative
-Judicial
district_id
Ballotpedia unique identifier
district_ocdid
The project seeks to assign somewhat predictable and globally unique identifiers to political divisions. This field is not uniformly filled due to data availability.
race_id
Ballotpedia unique identifier
race_type
One of the following:
-Regular
-Special
-Recall
-Retention
seats_up_for_election
The number of positions this race will fill in the office.
race_url
Link to the Ballotpedia overview page about this race/election.
election_date_id
Ballotpedia unique identifier
election_date
The date that the stage contest is scheduled to appear before voters.
election_date_district_type
Often linked to the State, provides additional detail about which geographical area might be having an election at this time.
stage_id
Ballotpedia unique identifier (stable across ranked-choice voting rounds, if applicable).
stage
One of the following:
-Convention
-Primary
-Primary Runoff
-General
-General Runoff
stage_party
For partisan primaries, provides a political party name. Each partisan primary or primary runoff will have its own stage.
candidate_id
Ballotpedia unique identifier
person_id
Ballotpedia unique identifier
name
Full name of the candidate
first_name
First name of the candidate
last_name
Last name of the candidate
ballotpedia_url
Link to the Ballotpedia profile about this candidate
Contact information is optional, available for an additional charge.
Values are listed below. The "campaign" contact is the one used by the candidate's campaign. All other contacts were identified as belonging to the candidate for non-campaign purposes.
Values:
campaign_email
other_email
campaign_website
personal_website
campaign_facebook
personal_facebook
campaign_x
personal_x
campaign_tiktok
personal_tiktok
campaign_instagram
personal_instagram
campaign_youtube
personal_youtube
campaign_mailing_address
campaign_phone
election_year
The year the race is occuring
state
{
"success": true,
"data": [
{
"id": "249",
"name": "New Jersey District 6",
"type": "Congress"
https://api4.ballotpedia.org/data/districts/point?lat=40.5550746&long=-74.27596989999999GET https://api.ballotpedia.org/getQueryListx-api-key: [your api key]{"success":true,"data":[{"id":"1098","title":"Endorsements Sample for Data Clients","description":"List endorsements for 2020 candidates"}],"message":null}POST https://api.ballotpedia.org/getQueryResultsx-api-key: [your api key]
Content-Type: application/json{
"id": "1098",
"format": "json"
}{
"id": "1098",
"format": "csv"
}{"success":true,"data":{"url":"https://ballotpedia-data-clients.s3.amazonaws.com/metabase_query_results_1253.json?AWSAccessKeyId=XXXXXXXXXXXXXXX&Expires=XXXXXXX&Signature=XXXXXXXX"},"message":"Success"}district_name
Name of district (geographical area) that elects the office.
district_type
Type of district that elects the office:
-Country
-State
-Congress
-State Legislative (Upper)
-State Legislative (Lower)
-County
-School District
-City-town
-Judicial District
-Special District
-State subdivision
-County subdivision
-Judicial district subdivision
-Special district subdivision
-City-town subdivision
-School district subdivision
parent_district_id
Ballotpedia unique identifier used to associate a "subdivision" district with its parent (not comprehensive). Example: "X City Council, District 1" and "X City Council, District 2" have a parent district of "X City".
parent_district_name
Name of parent district
is_partisan_primary
true / false for Primary or Primary Runoff stages, where applicable. Otherwise NULL. This indicates whether candidates in the primary were limited by party (such as a traditional Republican or Democratic Party primary) or not (such as an open primary in California). More information here: https://ballotpedia.org/Primary_election
stage_is_canceled
true / false to indicate if the stage has been canceled
stage_is_ranked_choice
true / false to indicate if the stage is conducted by ranked-choice voting
stage_write_in_other_votes
Includes additional write-in votes for the stage (votes that are not associated with a particular candidate, but relevant to vote totals).
gender
One of the following, or NULL:
-Male
-Female
-Neither/Both (if the person explicitly identifies as neither or both of the above)
party_affiliation
The political party affiliation that the candidate is running under (one or more). If the candidate is cross-filed in a primary, they will have a row for their participation in each party’s primary they are running in and this field will indicate that party. If they advanced to a general under more than one party, all those parties will be listed in this field.
Party affiliation for candidates in nonpartisan elections is listed as "Nonpartisan".
is_incumbent
true / false to indicate whether the candidate held the office they are seeking at the time of announcing their candidacy. See further details for how Ballotpedia handles appointees and redistricting situations here: https://ballotpedia.org/Incumbent
candidate_status
-Candidacy Declared: announced a run for the office but has not yet qualified for the ballot
-On the Ballot: filing with election office is complete, and the election office has published the person as an official candidate
-Advanced: The candidate received the most votes (or was one of the top vote recipients in a race with more than one seat up for election) in this stage of the election (such as a primary) and is going on to further rounds (such as a general). Effectively, this indicates the winner of a stage when the full race is not yet complete. This also applies to RCV stages, where a candidate may advance from multiple rounds within a single stage.
-Won: The candidate received the most votes (or was one of the top vote recipients in a race with more than one seat up for election) and will assume office.
-Lost: The candidate did not advance to another stage (or RCV round) and/or did not garner enough votes to win the seat.
-Withdrew: The candidate withdrew from the election and will not appear on the ballot.
-Disqualified: The candidate was disqualified from the election and will not appear on the ballot.
is_write_in
true / false to indicate if the candidate’s name was or will be printed on the ballot. Note that in some cases write-ins do file official paperwork and can thus have candidate_status=On the ballot while is_write_in=true.
is_withdrawn_still_on_ballot
true / false to capture scenarios where a candidate misses the official withdrawal deadline and will appear on the ballot despite announcing publicly their intent to withdraw
votes_for
Number of votes received in favor of the candidate in this stage (and RCV round, if applicable)
votes_against
Number of votes against the candidate. Only applicable to Recalls, Retentions, and RCVs.
delegates_pledged
Applicable to the general election for U.S. President
ranked_choice_voting_round
RCV results are reported in “rounds” of calculations. Ballotpedia reports each round of these results, so a candidate in an RCV stage will have a row for each round of calculation in that stage. The first round of results reported will be round "1". Rounds will count up by 1 until the final round.
name
The name or title of this ballot measure, including year
short_name
Abbreviated name of measure
district
Ballotpedia's unique district ID that this ballot measure covers
district_name
Name of district (typically a State)
district_type
Type of district
Proposed - The ballot measure has been proposed.
Pending official review - The ballot initiative has been filed with election officials but has not yet been cleared for signature gathering
Cleared for signature gathering - The ballot initiative has been cleared for signature gathering (campaigns can collect signatures).
Pending judicial ruling pre-election - Courts need to decide a case about the ballot measure before it can be certified for the ballot.
Not on the ballot - The proposed ballot measure has failed to make the ballot.
Certified to the legislature - When signatures are verified for an , they are sent to the legislature before being certified for the ballot. This gives the legislature the option to pass an initiative outright, rather than having it go to voters.
Approved by the legislature - This is an indirect initiative that legislators approved. In other words, the initiative was enacted by the legislature, rather than voters.
On the ballot - The ballot measure has been certified for the ballot.
Qualified for the ballot - This is a technicality. The ballot measure hasn’t been certified for the ballot but has qualified for the ballot. In California, for example, citizen-initiated ballot measures qualify for the ballot after enough signatures have been verified. However, the secretary of state doesn’t declare they’re on the ballot until 131 days before the election.
Approved - Voters approved the ballot measure.
Defeated - Voters rejected the ballot measure.
Too close to call - The election has happened, but we have not called the measure approved or defeated. Like candidate elections, when results are close, sometimes you need to wait for 100% of precincts to report results and/or absentee ballots to be received.
Pending judicial ruling post-election
Ballotpedia’s Geographic APIs allow anyone with an active API key to query the API endpoints.
Required parameters: These parameters are required to successfully hit the endpoint.
Optional parameters: These parameters are optional and accept one or more from the given comma separated list described under each endpoint.
Data points: Not all data points may be returned as shown in the examples depending on your API package.
Changes: We avoid making breaking changes to API endpoints or the structure of returned data without notice. New endpoints and data elements may be added at any time, but we alert our API customers via email 1 month in advance of small changes (like a field being renamed or its format changed) and 3 months in advance of larger changes (like data structure changes or endpoints being retired, etc.). We also avoid making such changes close to large elections to avoid disruptions. If you have questions about this policy, please contact [email protected].
All of the endpoints accept HTTP GET requests only. The following two HTTP headers must be included:
x-api-key: your_api_key
Content-Type: application/jsonData will be JSON-formatted text, and successful queries will receive an HTTP 200 response. Unsuccessful queries will respond with an appropriate HTTP response code in the 4xx or 5xx type.
Please note that in order to hit the following endpoints from an application on the internet, you must contact the Ballotpedia team to whitelist the domains from which those requests will originate. Requests from non-whitelisted origin domains will receive a preflight CORS permissions error. You are free to run test requests locally or in a non-cors context such as cURL, Postman, etc.
Via cURL:
Via PHP:
Via JavaScript:
Download sample data sets:
Signatures submitted - Signatures have been submitted for a ballot initiative and they are pending verification.
Overturned - Voters approved the ballot measure, but courts later overturned the measure as unconstitutional or otherwise invalid.
ocdid
The Open Civic Data Division Identifiers project seeks to assign somewhat predictable and globally unique identifiers to political divisions. This field is not uniformly filled due to data availability.
election_date
Date on which this measure will be on the ballot
status
The status of this ballot measure. For further detail on each of these, see status definitions below.
Options:
Proposed
Gathering signatures
Signatures submitted
Certified to the legislature
Qualified for the ballot
On the ballot
Approved
Defeated
Not on the ballot
Pending official review
Pending judicial ruling
Too close to call
type
The type of this ballot measure
Options:
Advisory question
Amendment
Automatic ballot referral
Bond issue
Bond question
City charter amendment
Combined initiated constitutional amendment
Commission-referred ballot measure
Constitutional amendment
Indirect initiated state statute
Initiated amendment
Initiated amendment and statute
Initiated constitutional amendment
Initiated state statute
Initiative
Initiative to the Legislature
Initiative to the People
Legislative referral
Legislatively referred constitutional amendment
Legislatively referred state statute
Local
Referendum
Referral
Referred ordinance
Statute
State statute
Veto referendum
topics
One or more (semicolon-separated) topics this ballot measure covers
summary
A summary of the measure
yes_vote
A custom explanation of what a YES vote means
no_vote
A custom explanation of what a NO vote means
yes_votes_total
The number of YES votes this ballot measure received
no_votes_total
The number of NO votes this ballot measure received
ballot_question
Text of the question to appear on the ballot.
source
A URL to the source of election results
url
The URL to a Ballotpedia page about this ballot measure
curl "https://api4.ballotpedia.org/data/the-endpoint-name-and-options" -X GET -H 'x-api-key: your-api-key' -H 'Content-Type: application/json' $curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api4.ballotpedia.org/data/the-endpoint-name-and-options',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => '',
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 0,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => 'GET',
CURLOPT_HTTPHEADER => array(
'Content-Type: application/json',
'x-api-key: your-api-key'
),
));
$response = curl_exec($curl);
curl_close($curl);
echo $response;var myHeaders = new Headers();
myHeaders.append("Content-Type", "application/json");
myHeaders.append("x-api-key", "your-api-key");
var requestOptions = {
method: 'GET',
headers: myHeaders
};
fetch("https://api4.ballotpedia.org/data/the-endpoint-name-and-options", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));In American elections, there are often multiple stages, phases, or dates associated with a single race or contest. The most common pattern is that of a Primary that leads to a General election. The Primary and the General are what we refer to as distinct Stages, while all are part of the overarching Race or contest to determine who will hold that Office for the next term.
Each row in our data set represents either one Candidate’s participation in one Stage, or, in the case of ranked-choice voting, one Candidate, Stage, and ranked-choice round. All candidates for a single contest can be grouped together by their Race ID; the results of any stage can be grouped together by Stage ID; and each candidate (campaign) will have the same Candidate ID for each row of data.
In the example graphic below, Candidate A and Candidate B will each have two rows, while Candidate C will only have one. All those rows will have the same Race ID and each row for each candidate will use the same Candidate ID. The Stage ID and Stage Type will help distinguish the stages from each other.
How do I see all the races happening in one state on the same date?
Filter your data set on State and Election date.
Why am I seeing this candidate more than once for the same stage?
This could be due to Ranked-Choice Voting (RCV) or cross-filing. It might also be that the candidate was disqualified under one party and continued to seek the election as a write-in. Look at the two records and see how their parties and status attributes compare.
Why am I seeing a candidate marked as advanced from one stage but no row for their next stage?
If the stage was recently held, the record for their participation in the next stage may be pending creation.
Cross-filing occurs when a candidate seeks office under more than one party. This is not allowed in all jurisdictions but is quite common in some states, such as New York and Pennsylvania. In these cases, the candidate will have more than one row in the dataset because of their running under multiple parties so long as they appear on the ballot for each party they run under. Imagine a candidate Luis Montega who is running for a local judgeship; he has cross-filed as a Democrat and a Republican.
Montega will have a row for each party’s primary that he participates in as he will appear on the ballot twice in that stage. Though each stage will have its own Stages ID, they will share the same Race ID, and Montega will have the same Candidate ID in all stages. Montega might lose both primaries, advance from only one, or advance from both. If he loses both, he will not have any additional rows (again, excepting if he seeks to participate in the general as a write-in). If he advances under one or both parties, he will have an additional row for the general stage. If he advanced under both, he will be identified as running under both parties in that row.
The graphic above illustrates this for a whole race with cross-filing: Candidate A and Candidate B would have three rows in the dataset and Candidate C would only have one. All those rows will have the same Race ID and each row for each candidate will use the same Candidate ID. The Stage ID and Stage Type will help distinguish the stages from each other.
is a related practice that can lead to a candidate having more than one party associated with them in your dataset.
is an electoral system in which voters rank candidates by preference on their ballots. If a candidate wins a majority of first-preference votes, he or she is declared the winner. If no candidate wins a majority of first-preference votes, the candidate with the fewest first-preference votes is eliminated. First-preference votes cast for the failed candidate are eliminated, lifting the second-preference choices indicated on those ballots. A new tally is conducted to determine whether any candidate has won a majority of the adjusted votes. The process is repeated until a candidate wins an outright majority.
Ballotpedia reports each round of these results, so a candidate in an RCV will have a row for each round of calculation in that stage. The first round of results reported will have this attribute = 1. Rounds will count up until the final round so the ultimate outcome will always be the highest round number in the stage.
For example, consider a race with four candidates using RCV. Voters ranked the candidates, and now we are trying to tally up a winner. The first round would look like this:
The candidates receive a status of advanced because they proceed to the next round of results calculation. None of our candidates received a majority of the first round, so the votes are redistributed in a second round. Note that some voters may not have marked a second preference and if their first preference (Candidate D) is disqualified at this point, their vote will not be transferred to any other candidates.
In this second round (and all subsequent rounds), we report the transferred votes, not a vote total for the candidate. In round 2, our disqualified candidate has all their votes transferred away from them and they now have a status of Lost that will be repeated in later rounds. The other candidates each receive votes as they were the second preference of the ballots cast for Candidate D. The vote totals for the candidates in this round (or any given subsequent round) can be found by summing their votes for and subtracting the sum of their votes against from those rounds (ex. Candidate A now has 2,100 votes). None of our candidates have a majority yet so we proceed to one more round where a winner can be determined:
There are some variations on how RCV works. In some multi-seat races (rows in your dataset where the seats up for election is greater than 1), one candidate may meet the majority requirement in an earlier round and be declared won in that stage while the other winners require more rounds of calculation to determine. In other multi-seat RCVs, the rounds may be used to calculate a first winner and then repeated without that winner included to determine additional winners.
Every four years, the presidential election presents a notable exception, in that it is a series of state-level Races for a single, national Office.
Many candidates file to run for this office with the Federal Election Commission and are given the candidate status of “Candidacy Declared.” However, only a portion of those will go on to appear on the ballot and participate in the state- and party-specific Stages. In these cases, the same candidate will often appear in the data set many times – once for Iowa’s Republican Caucus, once for a third-party primary in Nebraska, once for the Illinois Republican Primary, etc. For those that make it to the general election, that still means they can appear in multiple, distinct Stages – one for each state that they or their political party qualified to run in.
Note, too, that the delegates pledged attribute applies only to the Presidential race.
1500
Advanced
Candidate D
1
500
Advanced
75
Advanced
Candidate D
2
500
Lost
1575
Lost
Candidate D
3
Lost
Candidate
Ranked-choice voting round
Votes for
Votes against
Status
Candidate A
1
2000
Advanced
Candidate B
1
1800
Advanced
Candidate C
Candidate
Ranked-choice voting round
Votes for
Votes against
Status
Candidate A
2
100
Advanced
Candidate B
2
300
Advanced
Candidate C
Candidate
Ranked-choice voting round
Votes for
Votes against
Status
Candidate A
3
100
Lost
Candidate B
3
700
Won
Candidate C
1
2
3
Current officeholders endpoint
Given a latitude and longitude point, a list of current officeholders representing the point (address) will be returned with accompanying information and data points on the district, office, officeholder and person.
Required parameters: lat, long
Optional parameters: collections=social,contact
{
"success": true,
"data": [
{
"elected_officials": {
"districts": [
{
"name": "Wisconsin District 2",
"id": 430,
"type": "Congress",
"state": "WI",
"precise_boundary": true,
"offices": [
{
"id": 10859,
"name": "U.S. House Wisconsin District 2",
"type": "Representative",
"level": "Federal",
"branch": "Legislative",
"officeholders": [
{
"id": 37193,
"status": "Current",
"name": "Mark Pocan",
"last_name": "Pocan",
"url": "https://ballotpedia.org/Mark_Pocan",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "202-225-2906",
"contact_type": "Phone"
},
{
"contact": "https://pocan.house.gov/",
"contact_type": "Website"
}
],
"person_contact_information": null
}
]
}
]
},
{
"name": "Wisconsin",
"id": 562,
"type": "State",
"state": "WI",
"precise_boundary": true,
"offices": [
{
"id": 401,
"name": "Governor of Wisconsin",
"type": "Governor",
"level": "State",
"branch": "Executive",
"officeholders": [
{
"id": 56270,
"status": "Current",
"name": "Tony Evers",
"last_name": "Evers",
"url": "https://ballotpedia.org/Tony_Evers",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "https://evers.wi.gov/pages/home.aspx",
"contact_type": "Website"
},
{
"contact": "[email protected]",
"contact_type": "Email"
},
{
"contact": "608-266-1212",
"contact_type": "Phone"
}
],
"person_contact_information": null
}
]
},
{
"id": 9723,
"name": "Attorney General of Wisconsin",
"type": "Attorney General",
"level": "State",
"branch": "Executive",
"officeholders": [
{
"id": 294103,
"status": "Current",
"name": "Josh Kaul",
"last_name": "Kaul",
"url": "https://ballotpedia.org/Josh_Kaul",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "https://www.doj.state.wi.us/exec-profile/josh-kaul",
"contact_type": "Website"
},
{
"contact": "[email protected]",
"contact_type": "Email"
},
{
"contact": "608-266-1221",
"contact_type": "Phone"
}
],
"person_contact_information": null
}
]
},
{
"id": 11813,
"name": "U.S. Senate Wisconsin",
"type": "Senator",
"level": "Federal",
"branch": "Legislative",
"officeholders": [
{
"id": 53821,
"status": "Current",
"name": "Tammy Baldwin",
"last_name": "Baldwin",
"url": "https://ballotpedia.org/Tammy_Baldwin",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "202-224-5653",
"contact_type": "Phone"
},
{
"contact": "https://www.baldwin.senate.gov/",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 48568,
"status": "Current",
"name": "Ronald Harold Johnson",
"last_name": "Johnson",
"url": "https://ballotpedia.org/Ron_Johnson_(Wisconsin)",
"partisan_affiliation": 1,
"officeholder_contact_information": [
{
"contact": "[email protected]",
"contact_type": "Email"
},
{
"contact": "202-224-5323",
"contact_type": "Phone"
},
{
"contact": "https://www.ronjohnson.senate.gov/public/",
"contact_type": "Website"
}
],
"person_contact_information": null
}
]
},
{
"id": 21638,
"name": "Wisconsin Secretary of State",
"type": "Secretary of State",
"level": "State",
"branch": "Executive",
"officeholders": [
{
"id": 15676,
"status": "Current",
"name": "Douglas J. La Follette",
"last_name": "Follette",
"url": "https://ballotpedia.org/Douglas_La_Follette",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "[email protected]",
"contact_type": "Email"
},
{
"contact": "608-266-8888",
"contact_type": "Phone"
}
],
"person_contact_information": null
}
]
},
{
"id": 14513,
"name": "Lieutenant Governor of Wisconsin",
"type": "Lieutenant Governor",
"level": "State",
"branch": "Executive",
"officeholders": [
{
"id": 36064,
"status": "Current",
"name": "Mandela Barnes",
"last_name": "Barnes",
"url": "https://ballotpedia.org/Mandela_Barnes",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "https://evers.wi.gov/ltgov/Pages/About_LG.aspx",
"contact_type": "Website"
},
{
"contact": "[email protected]",
"contact_type": "Email"
},
{
"contact": "608-266-3516",
"contact_type": "Phone"
}
],
"person_contact_information": null
}
]
},
{
"id": 20865,
"name": "Wisconsin Superintendent of Public Instruction",
"type": "Superintendent of Schools",
"level": "State",
"branch": "Executive",
"officeholders": [
{
"id": 335652,
"status": "Current",
"name": "Jill Underly",
"last_name": "Underly",
"url": "https://ballotpedia.org/Jill_Underly",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-520-0547",
"contact_type": "Phone"
},
{
"contact": "https://dpi-transition.wi.gov/Pages/About.aspx",
"contact_type": "Website"
},
{
"contact": "[email protected]",
"contact_type": "Email"
}
],
"person_contact_information": [
{
"contact": "[email protected]",
"contact_type": "Email"
}
]
}
]
},
{
"id": 23727,
"name": "Greenfield City Council District 4",
"type": null,
"level": "Local",
"branch": "Legislative",
"officeholders": null
},
{
"id": 32705,
"name": "Milwaukee County Clerk of the Circuit Court",
"type": null,
"level": "Local",
"branch": "Executive",
"officeholders": null
},
{
"id": 10347,
"name": "Wisconsin Supreme Court",
"type": "Judge of court of last resort",
"level": "State",
"branch": "Judicial",
"officeholders": [
{
"id": 60167,
"status": "Current",
"name": "Ann Walsh Bradley",
"last_name": "Bradley",
"url": "https://ballotpedia.org/Ann_Walsh_Bradley",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-266-1886",
"contact_type": "Phone"
},
{
"contact": "https://wicourts.gov/courts/supreme/justices/bradley.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 85877,
"status": "Current",
"name": "Rebecca Bradley",
"last_name": "Bradley",
"url": "https://ballotpedia.org/Rebecca_Bradley",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-266-1883",
"contact_type": "Phone"
},
{
"contact": "https://wicourts.gov/courts/supreme/justices/rbradley.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 293943,
"status": "Current",
"name": "Rebecca Dallet",
"last_name": "Dallet",
"url": "https://ballotpedia.org/Rebecca_Dallet",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-266-1884",
"contact_type": "Phone"
},
{
"contact": "https://wicourts.gov/courts/supreme/justices/dallet.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 61839,
"status": "Current",
"name": "Brian Hagedorn",
"last_name": "Hagedorn",
"url": "https://ballotpedia.org/Brian_Hagedorn",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-266-1885",
"contact_type": "Phone"
},
{
"contact": "https://wicourts.gov/courts/supreme/justices/hagedorn.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 96029,
"status": "Current",
"name": "Jill Karofsky",
"last_name": "Karofsky",
"url": "https://ballotpedia.org/Jill_Karofsky",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-266-1882",
"contact_type": "Phone"
},
{
"contact": "https://www.wicourts.gov/courts/supreme/justices/karofsky.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 84124,
"status": "Current",
"name": "Patience Drake Roggensack",
"last_name": "Roggensack",
"url": "https://ballotpedia.org/Patience_Roggensack",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "608-266-1888",
"contact_type": "Phone"
},
{
"contact": "https://wicourts.gov/courts/supreme/justices/roggensack.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
},
{
"id": 60263,
"status": "Current",
"name": "Annette Ziegler",
"last_name": "Ziegler",
"url": "https://ballotpedia.org/Annette_Ziegler",
"partisan_affiliation": 7,
"officeholder_contact_information": [
{
"contact": "[email protected]",
"contact_type": "Email"
},
{
"contact": "608-266-1881",
"contact_type": "Phone"
},
{
"contact": "https://wicourts.gov/courts/supreme/justices/ziegler.htm",
"contact_type": "Website"
}
],
"person_contact_information": null
}
]
},
{
"id": 7210,
"name": "Wisconsin Treasurer",
"type": "Treasurer",
"level": "State",
"branch": "Executive",
"officeholders": [
{
"id": 298061,
"status": "Current",
"name": "Sarah Godlewski",
"last_name": "Godlewski",
"url": "https://ballotpedia.org/Sarah_Godlewski",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "https://statetreasurer.wi.gov/Pages/About-Sarah.aspx",
"contact_type": "Website"
},
{
"contact": "608-266-1714",
"contact_type": "Phone"
},
{
"contact": "[email protected]",
"contact_type": "Email"
}
],
"person_contact_information": null
}
]
}
]
},
{
"name": "Wisconsin State Senate District 26",
"id": 2452,
"type": "State Legislative (Upper)",
"state": "WI",
"precise_boundary": true,
"offices": [
{
"id": 28870,
"name": "Wisconsin State Senate District 26",
"type": "Senator",
"level": "State",
"branch": "Legislative",
"officeholders": [
{
"id": 31647,
"status": "Current",
"name": "Kelda Roys",
"last_name": "Roys",
"url": "https://ballotpedia.org/Kelda_Roys",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "608-266-1627",
"contact_type": "Phone"
},
{
"contact": "https://docs.legis.wisconsin.gov/2021/legislators/senate/2252",
"contact_type": "Website"
},
{
"contact": "[email protected]",
"contact_type": "Email"
}
],
"person_contact_information": null
}
]
}
]
},
{
"name": "Wisconsin State Assembly District 76",
"id": 7302,
"type": "State Legislative (Lower)",
"state": "WI",
"precise_boundary": true,
"offices": [
{
"id": 11319,
"name": "Wisconsin State Assembly District 76",
"type": "Representative",
"level": "State",
"branch": "Legislative",
"officeholders": [
{
"id": 330225,
"status": "Current",
"name": "Francesca Hong",
"last_name": "Hong",
"url": "https://ballotpedia.org/Francesca_Hong",
"partisan_affiliation": 2,
"officeholder_contact_information": [
{
"contact": "608-266-5342",
"contact_type": "Phone"
},
{
"contact": "https://docs.legis.wisconsin.gov/2021/legislators/assembly/2261",
"contact_type": "Website"
},
{
"contact": "[email protected]",
"contact_type": "Email"
}
],
"person_contact_information": null
}
]
}
]
},
{
"name": "Dane",
"id": 13889,
"type": "County",
"state": "WI",
"precise_boundary": true,
"offices": null
},
{
"name": "Madison Metropolitan School District",
"id": 28168,
"type": "School District",
"state": "WI",
"precise_boundary": true,
"offices": null
},
{
"name": "Wisconsin Court of Appeals District IV",
"id": 63613,
"type": "Judicial District",
"state": "WI",
"precise_boundary": false,
"offices": null
},
{
"name": "Dane County Circuit Court, Wisconsin",
"id": 63626,
"type": "Judicial District",
"state": "WI",
"precise_boundary": true,
"offices": null
},
{
"name": "Madison",
"id": 92584,
"type": "City-town",
"state": "WI",
"precise_boundary": true,
"offices": null
},
{
"name": "Madison City Council District 2",
"id": 95104,
"type": "City-town subdivision",
"state": "WI",
"precise_boundary": true,
"offices": null
},
{
"name": "Dane County Supervisor District 2",
"id": 95124,
"type": "County subdivision",
"state": "WI",
"precise_boundary": false,
"offices": null
},
{
"name": "Sanders County Sewer District at Paradise",
"id": 99105,
"type": "Special district subdivision",
"state": null,
"precise_boundary": false,
"offices": null
}
]
}
}
],
"message": null
}Election ballots and results (candidates running) by point
Given a latitude and longitude point and an election date, a list of candidates, ballot measures and races will be returned along with district, office, and person information for the particular point.
Races with no official candidates are not returned.
If the election date is in the future, a list of candidates and ballot measures are returned who are on the ballot in the upcoming election. If the election date is in the past, a list of candidates and ballot measures will be returned who were on the ballot for that past election.
Results of the election will be returned if included in your API package. Including which candidates won/lost, vote totals, and which ballot measures were approved or defeated.
Required parameters: lat, long, election_date
Optional parameters: collections=social,contact
https://api4.ballotpedia.org/data/elections_by_point?long=-88.72466949999999&lat=43.194246&election_date=2020-11-03https://api4.ballotpedia.org/data/elections_by_point?long=-88.72466949999999&lat=43.194246&election_date=2020-04-07{
"success": true,
"data": {
"longitude": -88.72466949999999,
"latitude": 43.194246,
"elections": [
{
"date": "2020-11-03",
"candidate_lists_complete": true,
"districts": [
{
"id": 93743,
"name": "United States",
"type": "Country",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31729,
"office": {
"id": 1,
"name": "President of the United States",
"level": "Federal",
"branch": "Executive",
"chamber": null,
"is_partisan": "Partisan all",
"type": null,
"seat": null,
"url": null,
"office_district": 93743
},
"office_district": 93743,
"url": "https://ballotpedia.org/Presidential_election,_2020",
"number_of_seats": 1,
"year": 2020,
"type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 54804,
"race": 31729,
"running_mate": "Mike Pence",
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 1610065,
"ranked_choice_voting_rounds": [],
"person": {
"id": 15180,
"name": "Donald Trump",
"first_name": "Donald",
"last_name": "Trump",
"url": "https://ballotpedia.org/Donald_Trump"
}
},
{
"id": 55042,
"race": 31729,
"running_mate": null,
"stage_party": null,
"party_affiliation": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"is_incumbent": false,
"is_write_in": true,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": null,
"ranked_choice_voting_rounds": [],
"person": {
"id": 312671,
"name": "Kasey Wells",
"first_name": "Kasey",
"last_name": "Wells",
"url": "https://ballotpedia.org/Kasey_Wells"
}
},
{
"id": 59216,
"race": 31729,
"running_mate": "Kamala D. Harris",
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 1630673,
"ranked_choice_voting_rounds": [],
"person": {
"id": 26709,
"name": "Joe Biden",
"first_name": "Joe",
"last_name": "Biden",
"url": "https://ballotpedia.org/Joe_Biden"
}
},
{
"id": 59781,
"race": 31729,
"running_mate": "Angela Nicole Walker",
"stage_party": null,
"party_affiliation": [
{
"id": 4,
"name": "Green Party",
"url": "https://ballotpedia.org/Green_Party"
}
],
"is_incumbent": false,
"is_write_in": true,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": null,
"ranked_choice_voting_rounds": [],
"person": {
"id": 21669,
"name": "Howie Hawkins",
"first_name": "Howie",
"last_name": "Hawkins",
"url": "https://ballotpedia.org/Howie_Hawkins"
}
},
{
"id": 65308,
"race": 31729,
"running_mate": "Spike Cohen",
"stage_party": null,
"party_affiliation": [
{
"id": 3,
"name": "Libertarian Party",
"url": "https://ballotpedia.org/Libertarian_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 38491,
"ranked_choice_voting_rounds": [],
"person": {
"id": 322425,
"name": "Jo Jorgensen",
"first_name": "Jo",
"last_name": "Jorgensen",
"url": "https://ballotpedia.org/Jo_Jorgensen"
}
},
{
"id": 65662,
"race": 31729,
"running_mate": "Amar Patel",
"stage_party": null,
"party_affiliation": [
{
"id": 17,
"name": "American Solidarity Party",
"url": null
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 5258,
"ranked_choice_voting_rounds": [],
"person": {
"id": 292603,
"name": "Brian T. Carroll",
"first_name": "Brian",
"last_name": "Carroll",
"url": "https://ballotpedia.org/Brian_T._Carroll"
}
},
{
"id": 66060,
"race": 31729,
"running_mate": "William Mohr",
"stage_party": null,
"party_affiliation": [
{
"id": 6,
"name": "Constitution Party",
"url": "https://ballotpedia.org/Constitution_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 5144,
"ranked_choice_voting_rounds": [],
"person": {
"id": 292195,
"name": "Don Blankenship",
"first_name": "Don",
"last_name": "Blankenship",
"url": "https://ballotpedia.org/Don_Blankenship_(West_Virginia)"
}
},
{
"id": 72757,
"race": 31729,
"running_mate": null,
"stage_party": null,
"party_affiliation": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"is_incumbent": false,
"is_write_in": true,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": null,
"ranked_choice_voting_rounds": [],
"person": {
"id": 312838,
"name": "President Boddie",
"first_name": "President",
"last_name": "Boddie",
"url": "https://ballotpedia.org/President_Boddie"
}
},
{
"id": 76526,
"race": 31729,
"running_mate": "Claudeliah Roze",
"stage_party": null,
"party_affiliation": [
{
"id": 21467,
"name": "Becoming One Nation",
"url": null
}
],
"is_incumbent": false,
"is_write_in": true,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": null,
"ranked_choice_voting_rounds": [],
"person": {
"id": 324666,
"name": "Jade Simmons",
"first_name": "Jade",
"last_name": "Simmons",
"url": "https://ballotpedia.org/Jade_Simmons"
}
}
]
}
]
},
{
"id": 433,
"name": "Wisconsin District 5",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31685,
"office": {
"id": 18366,
"name": "U.S. House Wisconsin District 5",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 5th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_5th_Congressional_District",
"office_district": 433
},
"office_district": 433,
"url": "https://ballotpedia.org/Wisconsin%27s_5th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 65365,
"race": 31685,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 265434,
"ranked_choice_voting_rounds": [],
"person": {
"id": 50408,
"name": "Scott Fitzgerald",
"first_name": "Scott",
"last_name": "Fitzgerald",
"url": "https://ballotpedia.org/Scott_Fitzgerald"
}
},
{
"id": 65431,
"race": 31685,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 175902,
"ranked_choice_voting_rounds": [],
"person": {
"id": 291468,
"name": "Tom Palzewicz",
"first_name": "Tom",
"last_name": "Palzewicz",
"url": "https://ballotpedia.org/Tom_Palzewicz"
}
}
]
}
]
},
{
"id": 7263,
"name": "Wisconsin State Assembly District 37",
"type": "State Legislative (Lower)",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 49591,
"office": {
"id": 6123,
"name": "Wisconsin State Assembly District 37",
"level": "State",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "District 37",
"url": "https://ballotpedia.org/Wisconsin_State_Assembly_District_37",
"office_district": 7263
},
"office_district": 7263,
"url": "https://ballotpedia.org/Wisconsin_State_Assembly_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 87590,
"race": 49591,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 14142,
"ranked_choice_voting_rounds": [],
"person": {
"id": 330171,
"name": "Abigail Lowery",
"first_name": "Abigail",
"last_name": "Lowery",
"url": "https://ballotpedia.org/Abigail_Lowery"
}
},
{
"id": 87592,
"race": 49591,
"stage_party": null,
"party_affiliation": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 1041,
"ranked_choice_voting_rounds": [],
"person": {
"id": 330173,
"name": "Stephen Ratzlaff Jr.",
"first_name": "Stephen",
"last_name": "Ratzlaff",
"url": "https://ballotpedia.org/Stephen_Ratzlaff_Jr."
}
},
{
"id": 87593,
"race": 49591,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 19406,
"ranked_choice_voting_rounds": [],
"person": {
"id": 27978,
"name": "John Jagler",
"first_name": "John",
"last_name": "Jagler",
"url": "https://ballotpedia.org/John_Jagler"
}
}
]
}
]
}
]
}
]
},
"message": null
}{
"success": true,
"data": {
"longitude": -88.72466949999999,
"latitude": 43.194246,
"elections": [
{
"date": "2020-04-07",
"candidate_lists_complete": false,
"districts": [
{
"id": 562,
"name": "Wisconsin",
"type": "State",
"precise_boundary": true,
"ballot_measures": [
{
"id": 10870,
"name": "Wisconsin Marsy's Law Crime Victims Rights Amendment (April 2020)",
"url": "https://ballotpedia.org/Wisconsin_Marsy%27s_Law_Crime_Victims_Rights_Amendment_(April_2020)",
"status": "Approved",
"type": "Legislatively referred constitutional amendment",
"district": 562,
"yes_vote": "
A \"yes\" vote supported this measure to add specific rights of crime victims, together known as a Marsy's Law, to the Wisconsin Constitution.
",
"no_vote": "
A \"no\" vote opposed this measure to add specific rights of crime victims to the state constitution beyond those found in Section 9m of Article I of the Wisconsin Constitution.
",
"official_title": "Question 1",
"election_date": "2020-04-07",
"yes_votes_total": 1107067,
"no_votes_total": 371013
}
],
"races": [
{
"id": 42310,
"office": {
"id": 10347,
"name": "Wisconsin Supreme Court",
"level": "State",
"branch": "Judicial",
"chamber": null,
"is_partisan": "Nonpartisan all",
"type": "Judge of court of last resort",
"seat": null,
"url": "https://ballotpedia.org/Wisconsin_Supreme_Court",
"office_district": 562
},
"office_district": 562,
"url": "https://ballotpedia.org/Wisconsin_Supreme_Court_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"type": "Regular",
"is_marquee": true,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 59733,
"race": 42310,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 693134,
"ranked_choice_voting_rounds": [],
"person": {
"id": 64913,
"name": "Daniel Kelly",
"first_name": "Daniel",
"last_name": "Kelly",
"url": "https://ballotpedia.org/Daniel_Kelly_(Wisconsin)"
}
},
{
"id": 59783,
"race": 42310,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 855573,
"ranked_choice_voting_rounds": [],
"person": {
"id": 96029,
"name": "Jill Karofsky",
"first_name": "Jill",
"last_name": "Karofsky",
"url": "https://ballotpedia.org/Jill_Karofsky"
}
}
]
}
]
},
{
"id": 63613,
"name": "Wisconsin Court of Appeals District IV",
"type": "Judicial District",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 50722,
"office": {
"id": 25941,
"name": "Wisconsin Court of Appeals District IV",
"level": "State",
"branch": "Judicial",
"chamber": null,
"is_partisan": "Nonpartisan all",
"type": null,
"seat": "District IV",
"url": null,
"office_district": 63613
},
"office_district": 63613,
"url": "https://ballotpedia.org/Wisconsin_intermediate_appellate_court_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 68634,
"race": 50722,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 341286,
"ranked_choice_voting_rounds": [],
"person": {
"id": 314654,
"name": "Rachel Graham",
"first_name": "Rachel",
"last_name": "Graham",
"url": "https://ballotpedia.org/Rachel_Graham"
}
}
]
}
]
}
]
}
]
},
"message": null
}Election ballots and results (candidates running) by state
Given a state and an election date, a list of candidates, ballot measures and races will be returned along with district, office, and person information for the entire state.
Races with no official candidates are not returned.
If the election date is in the future, a list of candidates and ballot measures are returned who are on the ballot in the upcoming election. If the election date is in the past, a list of candidates and ballot measures will be returned who were on the ballot for that past election.
Results of the election will be returned if included in your API package. Including which candidates won/lost, vote totals, and which ballot measures were approved or defeated.
Required parameters: abbreviated state, election_date
Optional parameters:
collections=social,contact
office_level=Federal,State,Local
office_branch=Legislative,Executive,Judicial
district_type=Country,Congress,State,State Legislative (Upper),State Legislative (Lower),Judicial District,County,County subdivision,City-town,School District,State subdivision,Special district subdivision,Judicial district subdivision,Special District,City-town subdivision,School district subdivision
page={number}
Results for Wisconsin congressional offices on November 3rd, 2020...
https://api4.ballotpedia.org/data/elections_by_state?state=WI&election_date=2020-11-03&office_level=Federal{
"success": true,
"data": {
"election_date": "2020-11-03",
"districts": [
{
"id": 429,
"name": "Wisconsin District 1",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31681,
"office": {
"id": 2462,
"name": "U.S. House Wisconsin District 1",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 1st Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_1st_Congressional_District",
"office_district": 429
},
"office_district": 429,
"url": "https://ballotpedia.org/Wisconsin%27s_1st_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 86856,
"race": 31681,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 238271,
"ranked_choice_voting_rounds": [],
"person": {
"id": 298470,
"name": "Bryan Steil",
"first_name": "Bryan",
"last_name": "Steil",
"url": "https://ballotpedia.org/Bryan_Steil"
}
},
{
"id": 71354,
"race": 31681,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 163170,
"ranked_choice_voting_rounds": [],
"person": {
"id": 322063,
"name": "Roger Polack",
"first_name": "Roger",
"last_name": "Polack",
"url": "https://ballotpedia.org/Roger_Polack"
}
}
]
}
]
},
{
"id": 430,
"name": "Wisconsin District 2",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31682,
"office": {
"id": 10859,
"name": "U.S. House Wisconsin District 2",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 2nd Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_2nd_Congressional_District",
"office_district": 430
},
"office_district": 430,
"url": "https://ballotpedia.org/Wisconsin%27s_2nd_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 64770,
"race": 31682,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 318523,
"ranked_choice_voting_rounds": [],
"person": {
"id": 37193,
"name": "Mark Pocan",
"first_name": "Mark",
"last_name": "Pocan",
"url": "https://ballotpedia.org/Mark_Pocan"
}
},
{
"id": 86859,
"race": 31682,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 138306,
"ranked_choice_voting_rounds": [],
"person": {
"id": 44392,
"name": "Peter Theron",
"first_name": "Peter",
"last_name": "Theron",
"url": "https://ballotpedia.org/Peter_Theron"
}
}
]
}
]
},
{
"id": 431,
"name": "Wisconsin District 3",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31683,
"office": {
"id": 6351,
"name": "U.S. House Wisconsin District 3",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 3rd Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_3rd_Congressional_District",
"office_district": 431
},
"office_district": 431,
"url": "https://ballotpedia.org/Wisconsin%27s_3rd_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 69082,
"race": 31683,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 199870,
"ranked_choice_voting_rounds": [],
"person": {
"id": 48575,
"name": "Ronald James Kind",
"first_name": "Ronald James",
"last_name": "Kind",
"url": "https://ballotpedia.org/Ron_Kind"
}
},
{
"id": 78990,
"race": 31683,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 189524,
"ranked_choice_voting_rounds": [],
"person": {
"id": 326054,
"name": "Derrick Van Orden",
"first_name": "Derrick",
"last_name": "Van Orden",
"url": "https://ballotpedia.org/Derrick_Van_Orden"
}
}
]
}
]
},
{
"id": 432,
"name": "Wisconsin District 4",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31684,
"office": {
"id": 3854,
"name": "U.S. House Wisconsin District 4",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 4th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_4th_Congressional_District",
"office_district": 432
},
"office_district": 432,
"url": "https://ballotpedia.org/Wisconsin%27s_4th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 69083,
"race": 31684,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 232668,
"ranked_choice_voting_rounds": [],
"person": {
"id": 20718,
"name": "Gwen Moore",
"first_name": "Gwen",
"last_name": "Moore",
"url": "https://ballotpedia.org/Gwen_Moore"
}
},
{
"id": 86863,
"race": 31684,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 70769,
"ranked_choice_voting_rounds": [],
"person": {
"id": 301297,
"name": "Tim Rogers",
"first_name": "Tim",
"last_name": "Rogers",
"url": "https://ballotpedia.org/Tim_Rogers_(Wisconsin)"
}
},
{
"id": 86862,
"race": 31684,
"stage_party": null,
"party_affiliation": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 7911,
"ranked_choice_voting_rounds": [],
"person": {
"id": 47819,
"name": "Robert Raymond",
"first_name": "Robert",
"last_name": "Raymond",
"url": "https://ballotpedia.org/Robert_Raymond"
}
}
]
}
]
},
{
"id": 433,
"name": "Wisconsin District 5",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31685,
"office": {
"id": 18366,
"name": "U.S. House Wisconsin District 5",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 5th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_5th_Congressional_District",
"office_district": 433
},
"office_district": 433,
"url": "https://ballotpedia.org/Wisconsin%27s_5th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 65431,
"race": 31685,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 175902,
"ranked_choice_voting_rounds": [],
"person": {
"id": 291468,
"name": "Tom Palzewicz",
"first_name": "Tom",
"last_name": "Palzewicz",
"url": "https://ballotpedia.org/Tom_Palzewicz"
}
},
{
"id": 65365,
"race": 31685,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 265434,
"ranked_choice_voting_rounds": [],
"person": {
"id": 50408,
"name": "Scott Fitzgerald",
"first_name": "Scott",
"last_name": "Fitzgerald",
"url": "https://ballotpedia.org/Scott_Fitzgerald"
}
}
]
}
]
},
{
"id": 434,
"name": "Wisconsin District 6",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31686,
"office": {
"id": 3154,
"name": "U.S. House Wisconsin District 6",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 6th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_6th_Congressional_District",
"office_district": 434
},
"office_district": 434,
"url": "https://ballotpedia.org/Wisconsin%27s_6th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 69084,
"race": 31686,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 238874,
"ranked_choice_voting_rounds": [],
"person": {
"id": 20002,
"name": "Glenn Grothman",
"first_name": "Glenn",
"last_name": "Grothman",
"url": "https://ballotpedia.org/Glenn_Grothman"
}
},
{
"id": 65708,
"race": 31686,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 164239,
"ranked_choice_voting_rounds": [],
"person": {
"id": 25644,
"name": "Jessica King",
"first_name": "Jessica",
"last_name": "King",
"url": "https://ballotpedia.org/Jessica_King_(Wisconsin)"
}
}
]
}
]
},
{
"id": 435,
"name": "Wisconsin District 7",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31687,
"office": {
"id": 4951,
"name": "U.S. House Wisconsin District 7",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 7th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_7th_Congressional_District",
"office_district": 435
},
"office_district": 435,
"url": "https://ballotpedia.org/Wisconsin%27s_7th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 86868,
"race": 31687,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 252048,
"ranked_choice_voting_rounds": [],
"person": {
"id": 56044,
"name": "Tom Tiffany",
"first_name": "Tom",
"last_name": "Tiffany",
"url": "https://ballotpedia.org/Tom_Tiffany"
}
},
{
"id": 85345,
"race": 31687,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 162741,
"ranked_choice_voting_rounds": [],
"person": {
"id": 293245,
"name": "Tricia Zunker",
"first_name": "Tricia",
"last_name": "Zunker",
"url": "https://ballotpedia.org/Tricia_Zunker"
}
}
]
}
]
},
{
"id": 436,
"name": "Wisconsin District 8",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31688,
"office": {
"id": 16129,
"name": "U.S. House Wisconsin District 8",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 8th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_8th_Congressional_District",
"office_district": 436
},
"office_district": 436,
"url": "https://ballotpedia.org/Wisconsin%27s_8th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 69085,
"race": 31688,
"stage_party": null,
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 268173,
"ranked_choice_voting_rounds": [],
"person": {
"id": 39493,
"name": "Mike Gallagher",
"first_name": "Mike",
"last_name": "Gallagher",
"url": "https://ballotpedia.org/Michael_Gallagher_(Wisconsin)"
}
},
{
"id": 60416,
"race": 31688,
"stage_party": null,
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 149558,
"ranked_choice_voting_rounds": [],
"person": {
"id": 1287,
"name": "Amanda Stuck",
"first_name": "Amanda",
"last_name": "Stuck",
"url": "https://ballotpedia.org/Amanda_Stuck"
}
}
]
}
]
}
]
},
"message": null
}https://api4.ballotpedia.org/data/elections_by_state?state=WI&election_date=2020-08-11{
"success": true,
"data": {
"election_date": "2020-08-11",
"districts": [
{
"id": 429,
"name": "Wisconsin District 1",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31681,
"office": {
"id": 2462,
"name": "U.S. House Wisconsin District 1",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 1st Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_1st_Congressional_District",
"office_district": 429
},
"office_district": 429,
"url": "https://ballotpedia.org/Wisconsin%27s_1st_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": false,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 62622,
"race": 31681,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 20608,
"ranked_choice_voting_rounds": [],
"person": {
"id": 301301,
"name": "Josh Pade",
"first_name": "Josh",
"last_name": "Pade",
"url": "https://ballotpedia.org/Josh_Pade"
}
},
{
"id": 71354,
"race": 31681,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 28697,
"ranked_choice_voting_rounds": [],
"person": {
"id": 322063,
"name": "Roger Polack",
"first_name": "Roger",
"last_name": "Polack",
"url": "https://ballotpedia.org/Roger_Polack"
}
}
]
},
{
"id": 31681,
"office": {
"id": 2462,
"name": "U.S. House Wisconsin District 1",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 1st Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_1st_Congressional_District",
"office_district": 429
},
"office_district": 429,
"url": "https://ballotpedia.org/Wisconsin%27s_1st_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 86856,
"race": 31681,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 40273,
"ranked_choice_voting_rounds": [],
"person": {
"id": 298470,
"name": "Bryan Steil",
"first_name": "Bryan",
"last_name": "Steil",
"url": "https://ballotpedia.org/Bryan_Steil"
}
}
]
}
]
},
{
"id": 430,
"name": "Wisconsin District 2",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31682,
"office": {
"id": 10859,
"name": "U.S. House Wisconsin District 2",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 2nd Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_2nd_Congressional_District",
"office_district": 430
},
"office_district": 430,
"url": "https://ballotpedia.org/Wisconsin%27s_2nd_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 64770,
"race": 31682,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 120353,
"ranked_choice_voting_rounds": [],
"person": {
"id": 37193,
"name": "Mark Pocan",
"first_name": "Mark",
"last_name": "Pocan",
"url": "https://ballotpedia.org/Mark_Pocan"
}
}
]
},
{
"id": 31682,
"office": {
"id": 10859,
"name": "U.S. House Wisconsin District 2",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 2nd Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_2nd_Congressional_District",
"office_district": 430
},
"office_district": 430,
"url": "https://ballotpedia.org/Wisconsin%27s_2nd_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 86859,
"race": 31682,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 18812,
"ranked_choice_voting_rounds": [],
"person": {
"id": 44392,
"name": "Peter Theron",
"first_name": "Peter",
"last_name": "Theron",
"url": "https://ballotpedia.org/Peter_Theron"
}
}
]
}
]
},
{
"id": 431,
"name": "Wisconsin District 3",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31683,
"office": {
"id": 6351,
"name": "U.S. House Wisconsin District 3",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 3rd Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_3rd_Congressional_District",
"office_district": 431
},
"office_district": 431,
"url": "https://ballotpedia.org/Wisconsin%27s_3rd_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 74688,
"race": 31683,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 18835,
"ranked_choice_voting_rounds": [],
"person": {
"id": 323890,
"name": "Jessi Ebben",
"first_name": "Jessi",
"last_name": "Ebben",
"url": "https://ballotpedia.org/Jessi_Ebben"
}
},
{
"id": 78990,
"race": 31683,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 36395,
"ranked_choice_voting_rounds": [],
"person": {
"id": 326054,
"name": "Derrick Van Orden",
"first_name": "Derrick",
"last_name": "Van Orden",
"url": "https://ballotpedia.org/Derrick_Van_Orden"
}
}
]
},
{
"id": 31683,
"office": {
"id": 6351,
"name": "U.S. House Wisconsin District 3",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 3rd Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_3rd_Congressional_District",
"office_district": 431
},
"office_district": 431,
"url": "https://ballotpedia.org/Wisconsin%27s_3rd_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 69082,
"race": 31683,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 53064,
"ranked_choice_voting_rounds": [],
"person": {
"id": 48575,
"name": "Ronald James Kind",
"first_name": "Ronald James",
"last_name": "Kind",
"url": "https://ballotpedia.org/Ron_Kind"
}
},
{
"id": 71870,
"race": 31683,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 12765,
"ranked_choice_voting_rounds": [],
"person": {
"id": 323092,
"name": "Mark A. Neumann",
"first_name": "Mark",
"last_name": "Neumann",
"url": "https://ballotpedia.org/Mark_Neumann_(Wisconsin_congressional_candidate)"
}
}
]
}
]
},
{
"id": 432,
"name": "Wisconsin District 4",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31684,
"office": {
"id": 3854,
"name": "U.S. House Wisconsin District 4",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 4th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_4th_Congressional_District",
"office_district": 432
},
"office_district": 432,
"url": "https://ballotpedia.org/Wisconsin%27s_4th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 69083,
"race": 31684,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 68898,
"ranked_choice_voting_rounds": [],
"person": {
"id": 20718,
"name": "Gwen Moore",
"first_name": "Gwen",
"last_name": "Moore",
"url": "https://ballotpedia.org/Gwen_Moore"
}
}
]
},
{
"id": 31684,
"office": {
"id": 3854,
"name": "U.S. House Wisconsin District 4",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 4th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_4th_Congressional_District",
"office_district": 432
},
"office_district": 432,
"url": "https://ballotpedia.org/Wisconsin%27s_4th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 86863,
"race": 31684,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 6685,
"ranked_choice_voting_rounds": [],
"person": {
"id": 301297,
"name": "Tim Rogers",
"first_name": "Tim",
"last_name": "Rogers",
"url": "https://ballotpedia.org/Tim_Rogers_(Wisconsin)"
}
},
{
"id": 71872,
"race": 31684,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 6598,
"ranked_choice_voting_rounds": [],
"person": {
"id": 301298,
"name": "Cindy Werner",
"first_name": "Cindy",
"last_name": "Werner",
"url": "https://ballotpedia.org/Cindy_Werner"
}
}
]
}
]
},
{
"id": 433,
"name": "Wisconsin District 5",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31685,
"office": {
"id": 18366,
"name": "U.S. House Wisconsin District 5",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 5th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_5th_Congressional_District",
"office_district": 433
},
"office_district": 433,
"url": "https://ballotpedia.org/Wisconsin%27s_5th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 65431,
"race": 31685,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 43710,
"ranked_choice_voting_rounds": [],
"person": {
"id": 291468,
"name": "Tom Palzewicz",
"first_name": "Tom",
"last_name": "Palzewicz",
"url": "https://ballotpedia.org/Tom_Palzewicz"
}
}
]
},
{
"id": 31685,
"office": {
"id": 18366,
"name": "U.S. House Wisconsin District 5",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 5th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_5th_Congressional_District",
"office_district": 433
},
"office_district": 433,
"url": "https://ballotpedia.org/Wisconsin%27s_5th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": true,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 83219,
"race": 31685,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 17829,
"ranked_choice_voting_rounds": [],
"person": {
"id": 328083,
"name": "Clifford DeTemple",
"first_name": "Clifford",
"last_name": "DeTemple",
"url": "https://ballotpedia.org/Clifford_DeTemple"
}
},
{
"id": 65365,
"race": 31685,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 60676,
"ranked_choice_voting_rounds": [],
"person": {
"id": 50408,
"name": "Scott Fitzgerald",
"first_name": "Scott",
"last_name": "Fitzgerald",
"url": "https://ballotpedia.org/Scott_Fitzgerald"
}
}
]
}
]
},
{
"id": 434,
"name": "Wisconsin District 6",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31686,
"office": {
"id": 3154,
"name": "U.S. House Wisconsin District 6",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 6th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_6th_Congressional_District",
"office_district": 434
},
"office_district": 434,
"url": "https://ballotpedia.org/Wisconsin%27s_6th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 69084,
"race": 31686,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 52247,
"ranked_choice_voting_rounds": [],
"person": {
"id": 20002,
"name": "Glenn Grothman",
"first_name": "Glenn",
"last_name": "Grothman",
"url": "https://ballotpedia.org/Glenn_Grothman"
}
}
]
},
{
"id": 31686,
"office": {
"id": 3154,
"name": "U.S. House Wisconsin District 6",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 6th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_6th_Congressional_District",
"office_district": 434
},
"office_district": 434,
"url": "https://ballotpedia.org/Wisconsin%27s_6th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": false,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 73552,
"race": 31686,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 7885,
"ranked_choice_voting_rounds": [],
"person": {
"id": 323313,
"name": "Michael Beardsley",
"first_name": "Michael",
"last_name": "Beardsley",
"url": "https://ballotpedia.org/Michael_Beardsley"
}
},
{
"id": 63649,
"race": 31686,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 4565,
"ranked_choice_voting_rounds": [],
"person": {
"id": 317776,
"name": "Matthew Boor",
"first_name": "Matthew",
"last_name": "Boor",
"url": "https://ballotpedia.org/Matthew_Boor"
}
},
{
"id": 65708,
"race": 31686,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 38039,
"ranked_choice_voting_rounds": [],
"person": {
"id": 25644,
"name": "Jessica King",
"first_name": "Jessica",
"last_name": "King",
"url": "https://ballotpedia.org/Jessica_King_(Wisconsin)"
}
}
]
}
]
},
{
"id": 435,
"name": "Wisconsin District 7",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31687,
"office": {
"id": 4951,
"name": "U.S. House Wisconsin District 7",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 7th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_7th_Congressional_District",
"office_district": 435
},
"office_district": 435,
"url": "https://ballotpedia.org/Wisconsin%27s_7th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 86868,
"race": 31687,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 62142,
"ranked_choice_voting_rounds": [],
"person": {
"id": 56044,
"name": "Tom Tiffany",
"first_name": "Tom",
"last_name": "Tiffany",
"url": "https://ballotpedia.org/Tom_Tiffany"
}
}
]
},
{
"id": 31687,
"office": {
"id": 4951,
"name": "U.S. House Wisconsin District 7",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 7th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_7th_Congressional_District",
"office_district": 435
},
"office_district": 435,
"url": "https://ballotpedia.org/Wisconsin%27s_7th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 85345,
"race": 31687,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 51139,
"ranked_choice_voting_rounds": [],
"person": {
"id": 293245,
"name": "Tricia Zunker",
"first_name": "Tricia",
"last_name": "Zunker",
"url": "https://ballotpedia.org/Tricia_Zunker"
}
}
]
}
]
},
{
"id": 436,
"name": "Wisconsin District 8",
"type": "Congress",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 31688,
"office": {
"id": 16129,
"name": "U.S. House Wisconsin District 8",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 8th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_8th_Congressional_District",
"office_district": 436
},
"office_district": 436,
"url": "https://ballotpedia.org/Wisconsin%27s_8th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 69085,
"race": 31688,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 50176,
"ranked_choice_voting_rounds": [],
"person": {
"id": 39493,
"name": "Mike Gallagher",
"first_name": "Mike",
"last_name": "Gallagher",
"url": "https://ballotpedia.org/Michael_Gallagher_(Wisconsin)"
}
}
]
},
{
"id": 31688,
"office": {
"id": 16129,
"name": "U.S. House Wisconsin District 8",
"level": "Federal",
"branch": "Legislative",
"chamber": "Lower",
"is_partisan": "Partisan all",
"type": "Representative",
"seat": "Wisconsin's 8th Congressional District",
"url": "https://ballotpedia.org/Wisconsin's_8th_Congressional_District",
"office_district": 436
},
"office_district": 436,
"url": "https://ballotpedia.org/Wisconsin%27s_8th_Congressional_District_election,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 60416,
"race": 31688,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 44793,
"ranked_choice_voting_rounds": [],
"person": {
"id": 1287,
"name": "Amanda Stuck",
"first_name": "Amanda",
"last_name": "Stuck",
"url": "https://ballotpedia.org/Amanda_Stuck"
}
}
]
}
]
},
{
"id": 2428,
"name": "Wisconsin State Senate District 2",
"type": "State Legislative (Upper)",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 49654,
"office": {
"id": 13559,
"name": "Wisconsin State Senate District 2",
"level": "State",
"branch": "Legislative",
"chamber": "Upper",
"is_partisan": "Partisan all",
"type": "Senator",
"seat": "District 2",
"url": "https://ballotpedia.org/Wisconsin_State_Senate_District_2",
"office_district": 2428
},
"office_district": 2428,
"url": "https://ballotpedia.org/Wisconsin_State_Senate_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 92418,
"race": 49654,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": false,
"is_write_in": true,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 286,
"ranked_choice_voting_rounds": [],
"person": {
"id": 56305,
"name": "Tony Lee",
"first_name": "Tony",
"last_name": "Lee",
"url": "https://ballotpedia.org/Tony_Lee"
}
}
]
},
{
"id": 49654,
"office": {
"id": 13559,
"name": "Wisconsin State Senate District 2",
"level": "State",
"branch": "Legislative",
"chamber": "Upper",
"is_partisan": "Partisan all",
"type": "Senator",
"seat": "District 2",
"url": "https://ballotpedia.org/Wisconsin_State_Senate_District_2",
"office_district": 2428
},
"office_district": 2428,
"url": "https://ballotpedia.org/Wisconsin_State_Senate_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": [
{
"id": 86297,
"race": 49654,
"stage_party": "Republican Party",
"party_affiliation": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 11224,
"ranked_choice_voting_rounds": [],
"person": {
"id": 47327,
"name": "Robert Cowles",
"first_name": "Robert",
"last_name": "Cowles",
"url": "https://ballotpedia.org/Robert_Cowles"
}
}
]
}
]
},
{
"id": 2430,
"name": "Wisconsin State Senate District 4",
"type": "State Legislative (Upper)",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 49655,
"office": {
"id": 28823,
"name": "Wisconsin State Senate District 4",
"level": "State",
"branch": "Legislative",
"chamber": "Upper",
"is_partisan": "Partisan all",
"type": "Senator",
"seat": "District 4",
"url": "https://ballotpedia.org/Wisconsin_State_Senate_District_4",
"office_district": 2430
},
"office_district": 2430,
"url": "https://ballotpedia.org/Wisconsin_State_Senate_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Democratic Party",
"candidates": [
{
"id": 86299,
"race": 49655,
"stage_party": "Democratic Party",
"party_affiliation": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Advanced",
"votes_for_cand": 16898,
"ranked_choice_voting_rounds": [],
"person": {
"id": 34367,
"name": "Lena Taylor",
"first_name": "Lena",
"last_name": "Taylor",
"url": "https://ballotpedia.org/Lena_Taylor"
}
}
]
},
{
"id": 49655,
"office": {
"id": 28823,
"name": "Wisconsin State Senate District 4",
"level": "State",
"branch": "Legislative",
"chamber": "Upper",
"is_partisan": "Partisan all",
"type": "Senator",
"seat": "District 4",
"url": "https://ballotpedia.org/Wisconsin_State_Senate_District_4",
"office_district": 2430
},
"office_district": 2430,
"url": "https://ballotpedia.org/Wisconsin_State_Senate_elections,_2020",
"number_of_seats": 1,
"year": 2020,
"race_type": "Regular",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": false,
"results_certified": true,
"stage_type": "Primary",
"stage_party": "Republican Party",
"candidates": null
}
]
}
]
},
"message": null
}{
"id": 93938,
"name": "San Francisco Board of Supervisors District 5",
"type": "County subdivision",
"precise_boundary": true,
"ballot_measures": null,
"races": [
{
"id": 42896,
"office": {
"id": 12637,
"name": "San Francisco Board of Supervisors District 5",
"level": "Local",
"branch": "Legislative",
"chamber": null,
"is_partisan": "Nonpartisan all",
"type": "City council",
"seat": "District 5",
"url": null,
"office_district": 93938
},
"office_district": 93938,
"url": "https://ballotpedia.org/City_elections_in_San_Francisco,_California_(2019)",
"number_of_seats": 1,
"year": 2019,
"race_type": "Special",
"is_marquee": false,
"office_position": null,
"is_ranked_choice": true,
"results_certified": true,
"stage_type": "General",
"stage_party": null,
"candidates": [
{
"id": 59977,
"race": 42896,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": true,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 11538,
"ranked_choice_voting_rounds": [
{
"rcv_round": 1,
"votes_for": 11208,
"status": "Advanced"
},
{
"rcv_round": 2,
"votes_for": 51,
"status": "Advanced"
},
{
"rcv_round": 3,
"votes_for": 279,
"status": "Lost"
}
],
"person": {
"id": 304529,
"name": "Vallie Brown",
"first_name": "Vallie",
"last_name": "Brown",
"url": "https://ballotpedia.org/Vallie_Brown"
}
},
{
"id": 59980,
"race": 42896,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 1035,
"ranked_choice_voting_rounds": [
{
"rcv_round": 1,
"votes_for": 950,
"status": "Advanced"
},
{
"rcv_round": 2,
"votes_for": 85,
"status": "Advanced"
},
{
"rcv_round": 3,
"votes_for": null,
"status": "Lost"
}
],
"person": {
"id": 314488,
"name": "Ryan Lam",
"first_name": "Ryan",
"last_name": "Lam",
"url": "https://ballotpedia.org/Ryan_Lam"
}
},
{
"id": 59979,
"race": 42896,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Lost",
"votes_for_cand": 278,
"ranked_choice_voting_rounds": [
{
"rcv_round": 1,
"votes_for": 278,
"status": "Advanced"
},
{
"rcv_round": 2,
"votes_for": null,
"status": "Lost"
},
{
"rcv_round": 3,
"votes_for": 0,
"status": "Lost"
}
],
"person": {
"id": 314487,
"name": "Nomvula O'Meara",
"first_name": "Nomvula",
"last_name": "O'Meara",
"url": "https://ballotpedia.org/Nomvula_O'Meara"
}
},
{
"id": 59978,
"race": 42896,
"stage_party": null,
"party_affiliation": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"is_incumbent": false,
"is_write_in": false,
"withdrew_still_on_ballot": false,
"cand_status": "Won",
"votes_for_cand": 11723,
"ranked_choice_voting_rounds": [
{
"rcv_round": 1,
"votes_for": 11239,
"status": "Advanced"
},
{
"rcv_round": 2,
"votes_for": 70,
"status": "Advanced"
},
{
"rcv_round": 3,
"votes_for": 414,
"status": "Won"
}
],
"person": {
"id": 13552,
"name": "Dean Preston",
"first_name": "Dean",
"last_name": "Preston",
"url": "https://ballotpedia.org/Dean_Preston"
}
}
]
}
]
}