Turnout

Registered voters and ballots cast in a contest’s jurisdiction for its election: the denominator for turnout and roll-off.

Returned by: GET /v1/contests, GET /v1/contests/{id}, GET /v1/elections/{slug}/export
Found in: Contest result (turnout)

How it connects

In a contest’s result.turnout. Roll-off is 1 − result.total_votes / ballots_cast.
With format=csv, GET /v1/contests has turnout_registered_voters, turnout_ballots_cast and turnout_pct.

Good to know

Only where the contest’s district is a jurisdiction that reports turnout: a state, or a county, city or town with its own election board. Other contests have null.
2020, 2022 and 2024 come from the U.S. Election Assistance Commission’s Election Administration and Voting Survey (public domain); 2026 from the state election offices that publish it, and only where they do.
turnout_pct is never against the voting-age population; use the district’s demographics.citizen_voting_age_population for that.
turnout is inside result, so it is null until the contest has a result.

Fields

Field	Type	Meaning	Example
`registered_voters`	integeror null	Registered voters in the jurisdiction, as the source counts them (the EAC’s survey counts active and inactive registrants); null where the source gives none, as in North Dakota, which has no registration.	`596864`
`ballots_cast`	integeror null	Voters who cast a ballot that was counted, as the source reports it.	`411691`
`turnout_pct`	numberor null	The source’s own turnout percentage when it prints one, else ballots_cast / registered_voters × 100. Never against the voting-age population.	`68.98`
`status`	string	unofficial while the counts can still change; certified once canvassed.`unofficial`, `certified` meanings	`certified`
`source`	object	The source of the counts.	—
`source.name`	string	Who published the counts.	`U.S. Election Assistance Commission, Election Administration and Voting Survey 2024`
`source.url`	stringURL	Where the counts was published.	`https://www.eac.gov/sites/default/files/2026-02/2024_EAVS_for_Public_Release_nolabel_V2_c…`
`retrieved_on`	stringYYYY-MM-DD	When we read it from the source.	`2026-11-14`

Download every dictionary as CSV or JSON.

Sample (JSON)

One turnout as the API returns it. More in the sample data.

{
  "registered_voters": 596864,
  "ballots_cast": 411691,
  "turnout_pct": 68.98,
  "status": "certified",
  "source": {
    "name": "U.S. Election Assistance Commission, Election Administration and Voting Survey 2024",
    "url": "https://www.eac.gov/sites/default/files/2026-02/2024_EAVS_for_Public_Release_nolabel_V2_csv.zip"
  },
  "retrieved_on": "2026-11-14"
}