Sample data
These are real responses from the API, saved as files you can download without an API key. They are small on purpose: a page or two of records from each endpoint, and one election export cut down to a few contests of each kind, enough to build against and to see every shape the data takes.
What each coded value means (vote_method, kind, status and the rest) is on the Field values page, and every field is described in the API reference.
A sample election export
A whole election in one file is what most customers start with. The sample has a few contests of each kind: vote for one, vote for N, ranked choice, ballot measures and judicial retention, with their results and every endorser’s position. The full export has every contest on the ballot.
| File | Request | What’s in it |
|---|---|---|
| Election export (JSON) | GET /v1/elections/ca-2026-11-03-general/export | The export of one election, cut down to a few contests of each kind: the election and its voting rules, then each contest with its office, district, choices, result and every endorser’s position. |
| Election export (CSV) | GET /v1/elections/ca-2026-11-03-general/export?format=csv | The same contests as CSV: one row per endorsement, with its election, contest, district, choice and result. |
Sample responses
One response from each data endpoint, exactly as the API returned it. Lists are cut to a few records, so their next_cursor points at a page you’d need a key to read.
| File | Request | What’s in it |
|---|---|---|
| States | GET /v1/states | Every state, with its FIPS code. |
| Elections | GET /v1/elections?states=CA&limit=5 | Elections with their voting rules and counts. |
| Coverage | GET /v1/coverage | Per state: elections, contests, measures, endorsers and endorsements. |
| Endorser categories | GET /v1/endorser-categories | The kinds of endorser. |
| Endorsers | GET /v1/endorsers?states=CA&limit=5 | Endorsers with their category, home state and endorsement count. |
| Contests | GET /v1/contests?elections=ca-2026-11-03-general&limit=3 | Contests with their office, district, choices and results. |
| One contest | GET /v1/contests/92 | A ranked-choice city council race with every endorser’s position and rank. |
| Endorsements | GET /v1/endorsements?elections=ca-2026-11-03-general&limit=5 | Endorsements, flat, with the basics of each. |
| One endorsement | GET /v1/endorsements/51411 | An endorsement in full: statement, source, endorser, contest and choice. |
| Candidates | GET /v1/candidates?states=CA&limit=3 | Candidates with their contests, endorsement counts and contact details. |
| One candidate | GET /v1/candidates/5 | A candidate with every endorsement received, campaign finance and issue positions. |
| Measure topics | GET /v1/measure-topics | The topics measures are tagged with. |
| Issues | GET /v1/issues | The issues candidates’ positions are recorded on. |
| Issue positions | GET /v1/issue-positions?limit=3 | Where candidates stand, with sources. |
| Officeholders | GET /v1/officeholders?states=CA&limit=3 | Who holds each seat now. |