Data dictionaries

Election export (JSON)

A whole election in one download: the election, then every contest with its choices, result and every endorser’s position.

Returned by
GET /v1/elections/{slug}/export

How it connects

  • The election is given once at the top; each contest has the same fields as a Contest without its election.

Good to know

  • Contests are in ballot order: races from federal down, then measures. Every contest you can read is there, endorsed or not.

Fields

FieldTypeMeaningExample
electionElectionThe election the contest is in.—
contestsarray of ContestEvery contest you can read in the election, in ballot order: races from federal down, then measures.—

Download every dictionary as CSV or JSON.

Election export (JSON) data dictionary · BallotData API