> For the complete documentation index, see [llms.txt](https://developer.ballotpedia.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.ballotpedia.org/geographic-apis/elections_by_state.md). # /elections\_by\_state 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} ### Example for statewide results Results for Wisconsin congressional offices on November 3rd, 2020...
Example call ``` https://api4.ballotpedia.org/data/elections_by_state?state=WI&election_date=2020-11-03&office_level=Federal ```
Example response ```json { "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, "race_disclaimers": [ { "id": 145, "sort": 1, "text": "This is a race-wide disclaimer." } ], "stage_disclaimers": null, "candidates": [ { "id": 86856, "fec_id": "H8WI01156", "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, "fec_id": "H0WI01120", "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, "race_disclaimers": null, "stage_disclaimers": [ { "id": 210, "sort": 1, "text": "Due to a state law change, the deadline to return absentee ballots was extended for this election." } ], "candidates": [ { "id": 64770, "fec_id": "H2WI02124", "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, "fec_id": "H8WI02121", "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, "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69082, "fec_id": "H6WI03099", "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, "fec_id": "H0WI03175", "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, "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69083, "fec_id": "H4WI04183", "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, "fec_id": "H8WI04069", "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, "fec_id": "H4WI04266", "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, "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 65431, "fec_id": "H8WI05165", "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, "fec_id": "H0WI05113", "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, "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69084, "fec_id": "H4WI06048", "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, "fec_id": "H0WI06186", "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, "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 86868, "fec_id": "H0WI07101", "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, "fec_id": "H0WI07135", "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, "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69085, "fec_id": "H6WI08155", "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, "fec_id": "H0WI08125", "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" } } ] } ] } ], "total_pages": 1 }, "message": null } ```
### Partisan primaries {% hint style="info" %} When a race is a partisan primary, multiple objects will exist in the races array for the respective political party primary. This is defined as **stage\_party**. This applies to both the By Point and By State endpoints. Example below. {% endhint %}
Example call ``` https://api4.ballotpedia.org/data/elections_by_state?state=WI&election_date=2020-08-11 ```
Example response ```json { "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", "race_disclaimers": [ { "id": 145, "sort": 1, "text": "This is a race-wide disclaimer." } ], "stage_disclaimers": null, "candidates": [ { "id": 62622, "fec_id": "H0WI01104", "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, "fec_id": "H0WI01120", "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", "race_disclaimers": null, "stage_disclaimers": [ { "id": 210, "sort": 1, "text": "Due to a state law change, the deadline to return absentee ballots was extended for this election." } ], "candidates": [ { "id": 86856, "fec_id": "H8WI01156", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 64770, "fec_id": "H2WI02124", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 86859, "fec_id": "H8WI02121", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 74688, "fec_id": "H0WI03159", "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, "fec_id": "H0WI03175", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69082, "fec_id": "H6WI03099", "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, "fec_id": "H0WI03118", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69083, "fec_id": "H4WI04183", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 86863, "fec_id": "H8WI04069", "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, "fec_id": "H0WI04132", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 65431, "fec_id": "H8WI05165", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 83219, "fec_id": "H0WI05121", "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, "fec_id": "H0WI05113", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69084, "fec_id": "H4WI06048", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 73552, "fec_id": "H0WI06210", "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, "fec_id": "H0WI06178", "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, "fec_id": "H0WI06186", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 86868, "fec_id": "H0WI07101", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 85345, "fec_id": "H0WI07135", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 69085, "fec_id": "H6WI08155", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 60416, "fec_id": "H0WI08125", "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 92418, "fec_id": null, "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 86297, "fec_id": null, "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": [ { "id": 86299, "fec_id": null, "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", "race_disclaimers": null, "stage_disclaimers": null, "candidates": null } ] } ], "total_pages": 2 }, "message": null } ```
### **Ranked-choice voting** {% hint style="info" %} *When a race utilizes Ranked Choice Voting, **is\_ranked\_choice** will be true. The **ranked\_choice\_voting\_rounds** array will be populated with the candidate's round results. The **cand\_status** data point reflects their result at the end of the RCV voting. The **votes\_for\_cand** reflects the total number of votes throughout the rounds. This applies to both the By Point and By State endpoints in which the race uitilizes RCV. Example below.* {% endhint %}
Example response ```json { "success": true, "data": { "election_date": "2019-11-05", "districts": [ { "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, "race_disclaimers": [ { "id": 145, "sort": 1, "text": "This is a race-wide disclaimer." } ], "stage_disclaimers": [ { "id": 210, "sort": 1, "text": "Due to a state law change, the deadline to return absentee ballots was extended for this election." } ], "candidates": [ { "id": 59977, "fec_id": null, "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, "fec_id": null, "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, "fec_id": null, "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, "fec_id": null, "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" } } ] } ] } ], "total_pages": 1 }, "message": null } ```
--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://developer.ballotpedia.org/geographic-apis/elections_by_state.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.