Data dictionaries

Coverage

How much data we have for one state.

Returned by
GET /v1/coverage

Good to know

  • Counts are for upcoming elections unless you pass upcoming=false.

Fields

FieldTypeMeaningExample
statestringTwo capital letters (USPS code)USPS state code.AK
namestringState name.Alaska
election_countintegerElections in this state.0
contest_countintegerContests in those elections.0
measure_countintegerOf those, ballot measures.0
endorser_countintegerEndorsers with endorsements here.0
endorsement_countintegerEndorsements in those contests.0
endorsed_contest_countintegerContests with at least one endorsement.0
first_electionstringor nullYYYY-MM-DDDay of the earliest election counted.—
last_electionstringor nullYYYY-MM-DDDay of the latest election counted.—
updated_atstringor nullISO 8601 date and time with time zoneWhen a contest or endorsement last changed.—

Download every dictionary as CSV or JSON.

Coverage data dictionary · BallotData API