US Elections

Election Night Races

Races that are being counted right now on election night, each with the candidate who is leading and the runner-up, votes and shares, the lead in votes and points, the percent of precincts reported and the time of the last change. Counts are unofficial and still changing. A race is only ever shown as leading, never as won.

All filters are optional. The answer is {updated_at, unofficial, note, total, rows}. Before any state starts counting the rows list is empty.

get/elections/live/races

Request

  • Base URL: https://api.dataporium.io
  • URL: https://api.dataporium.io/elections/live/races
  • Auth: API key in query parameter apikey

Query parameters

officestring

president, us_senate, us_house, governor, lt_governor, attorney_general, secretary_of_state, treasurer, other_statewide, state_senate, state_house, ballot_measure or judicial (comma-separated)

statestring

Two-letter state code(s), comma-separated

closeboolean

true = only close races (lead under 5 points)

sortstring

updated, margin, state, office, total_votes or reported

orderstring

asc or desc

limitinteger

Rows per page (default 100, at most 500)

offsetinteger

Rows to skip, for paging

Response

Successful response (JSON).

object required

Changes

No recorded changes to this operation across all 1 revision of this API.