Complete ballot data
Every package in one: races, candidates, ballot measures, incumbents and officeholders, endorsements, and districts with maps. One license, one delivery, and it all fits together.
Upcoming elections in all 50 states and DC. Coverage by state · Technical details for developers
Races
30,000+ races · 100+ ranked-choice races
What’s included
Each office on the ballot as it is printed, with the area that votes on it. Shows how each race is voted: pick one, pick several, rank the candidates, or vote to keep a judge, and which races appear only on one party's primary ballot.
- Election
- Name, date, state and type (general, primary, special or runoff)
- Office
- The title printed on the ballot, with a short version
- Area
- The district that votes on it, from federal and state down to county, city, school and special districts
- How it's voted
- Pick one, pick several, ranked choice, or yes/no
- Party ballot
- Whether the race appears only on one party's primary ballot
- Ballot order
- Where it sits on the printed ballot, when published
- Spanish
- Translated titles where the county prints them
Races by level of government
Candidates
60,000+ candidates
What’s included
Each candidate as the voter sees them: the name printed on the ballot, the occupation or designation line, party or party preference, ballot order and withdrawals, plus a website and photo when the candidate publishes one.
- Ballot name
- Exactly as printed
- Race
- The race the candidate is running in
- Ballot designation
- The occupation line, e.g. "Transit Planner", where the state prints one
- Party
- Party or stated party preference
- Status
- Ballot order, and whether the candidate withdrew
- Links
- Campaign website and photo, when published
Races by how they’re voted
Ballot measures
3,000+ ballot measures
What’s included
Every proposition, initiative, bond and charter amendment we have found, with its letter or number, official title, a one-line summary and the Yes and No choices endorsers take positions on.
- Measure
- Its letter or number, e.g. "Prop 5" or "Measure K"
- Official title
- As printed on the ballot
- Summary
- One plain-language line
- Who votes on it
- The state, county, city or district
- Choices
- Yes and No, so endorsements can take a side
Measures by level of government
Incumbents and officeholders
12,000+ incumbents running · 8,000+ current officeholders
What’s included
Which candidates already hold the seat they are running for, and a directory of current officeholders (members of Congress, governors and statewide officers, state legislators) with their districts, party, term and public contact details.
- Incumbent
- Whether each candidate holds the seat they are running for
- Officeholder
- Name, office and title
- District
- As the legislature names it
- Party and term
- Party, and when the term started and ends
- Contact
- Office addresses, phone, email, website and social media
Officeholders by office
Endorsements
30,000+ endorsements · 500+ endorsers
What’s included
Every endorsement and voting recommendation we have gathered, each linked to where it was published. Endorsers are grouped by type, so you can compare, for example, what labor unions recommend with what newspapers do. Ranked-choice picks keep their order, and measure positions are Yes or No.
- Endorser
- Name, type (labor union, newspaper, party, advocacy group, elected official…), home state and website
- Pick
- The candidate, or Yes or No on a measure, with the rank for ranked-choice races
- Source
- A link to where the endorsement was published, and the date
- Statement
- The endorser's reasoning, when they gave one
Endorsements by kind of endorser
Districts and boundaries
20,000+ districts · 1,300+ with boundary maps
What’s included
The districts our races are voted in, with what it takes to find the right ones for any address: standard Census codes where the Census publishes the district, and boundary maps we have built for the ones it doesn't, like supervisor and council districts, special districts and lines redrawn since the Census.
- District
- Name, level and type
- Matching codes
- Standard codes that line up with Census and other public data
- Map
- The district's boundary, where we have one
- Dates
- When the lines took effect, and when they end