Explore Plans
Mobile menu Close menu
Google Civic Information

What's on my ballot

Pro plus icon This query returns the contests and ballot measures for a US street address in the next upcoming election, in ballot order, with the candidates for each. Returns nothing when Google has no information yet for the address.

Developer info

API endpoint slug
google_civic_information.whats_on_my_ballot
Runtime method
performQuery("google_civic_information.whats_on_my_ballot"}

Query fields

Address Text input > Other

Label
Street address
Helper text
A US residential address, e.g. 340 Main St, Venice, CA 90291. Results cover the next election Google has information for at this address.
Slug
address
Required
true
Can have default value
true

Ingredients

Title Title of the contest or ballot measure as it appears on the ballot.

Slug
title
Filter code
GoogleCivicInformation.whatsOnMyBallot.Title
Type
String
Example
United States Representative, 36th District

Contest type Type of contest, e.g. General, Primary, Run-off, Referendum, or ballot-measure.

Slug
contest_type
Filter code
GoogleCivicInformation.whatsOnMyBallot.ContestType
Type
String
Example
General

District Name of the district the contest covers.

Slug
district
Filter code
GoogleCivicInformation.whatsOnMyBallot.District
Type
String
Example
36th US Congressional

District scope Scope of the district, e.g. statewide, congressional, citywide.

Slug
district_scope
Filter code
GoogleCivicInformation.whatsOnMyBallot.DistrictScope
Type
String
Example
congressional

Candidates Candidates with party, separated by semicolons. Empty for ballot measures.

Slug
candidates
Filter code
GoogleCivicInformation.whatsOnMyBallot.Candidates
Type
String
Example
Ted W. Lieu (Democratic); Ariana Hakami (Republican)

Candidate count Number of candidates in the contest.

Slug
candidate_count
Filter code
GoogleCivicInformation.whatsOnMyBallot.CandidateCount
Type
String
Example
2

Number voting for How many candidates a voter may choose.

Slug
number_voting_for
Filter code
GoogleCivicInformation.whatsOnMyBallot.NumberVotingFor
Type
String
Example
1

Measure text Full text of a ballot measure. Empty for candidate contests.

Slug
measure_text
Filter code
GoogleCivicInformation.whatsOnMyBallot.MeasureText
Type
String
Example
Hello World!

Ballot responses Possible answers for a ballot measure, comma separated.

Slug
ballot_responses
Filter code
GoogleCivicInformation.whatsOnMyBallot.BallotResponses
Type
String
Example
Yes, No

Ballot placement Position of the contest on the ballot.

Slug
ballot_placement
Filter code
GoogleCivicInformation.whatsOnMyBallot.BallotPlacement
Type
String
Example
103

Election name Name of the election.

Slug
election_name
Filter code
GoogleCivicInformation.whatsOnMyBallot.ElectionName
Type
String
Example
2026 General Midterm Election

Election day Date of the election.

Slug
election_day
Filter code
GoogleCivicInformation.whatsOnMyBallot.ElectionDay
Type
Date (ISO8601)
Example
2020-07-07

Election Google's identifier for the election.

Slug
election_id
Filter code
GoogleCivicInformation.whatsOnMyBallot.ElectionId
Type
String
Example
12000