/elections_by_point
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
Example call
https://api4.ballotpedia.org/data/elections_by_point?long=-88.72466949999999&lat=43.194246&election_date=2020-11-03Example response
{
"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",
"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",
"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)",
"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
}Ballot measures
When ballot measures are or were on the ballot, they will populate the ballot_measures data point as an array for their respective district. Example below.
Example call
https://api4.ballotpedia.org/data/elections_by_point?long=-88.72466949999999&lat=43.194246&election_date=2020-04-07Example response
{
"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",
"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",
"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
}Last updated