Developers and partners

Put every election where people already look

Newsrooms, libraries, schools, employers and civic apps can reuse everything here, free, with attribution.

Embed a jurisdiction

Upcoming elections and the next deadline for any state, county, city or district. It renders in its own shadow root, so your styles and ours never collide.

<div data-every-election="ocd-division/country:us/state:ok/county:cleveland"
     data-theme="auto" data-limit="3"></div>
<script async src="https://everyelection.app/embed.js"
        data-api="https://api.everyelection.app" data-site="https://everyelection.app"></script>

data-theme: light, dark, or auto (follows the reader’s system).
data-limit: 1 to 10 elections (default 3).
Find any jurisdiction’s id on its page: search places, then use “Embed”.

Calendar feeds

Subscribe once in Google Calendar, Apple Calendar or Outlook; the feed updates as offices publish.

https://api.everyelection.app/ics/division/ocd-division/country:us/state:ok/county:cleveland.ics
https://api.everyelection.app/ics/divisions/{ocd_id},{ocd_id},….ics   (up to 40 jurisdictions)
https://api.everyelection.app/ics/election/{id}.ics

Universities and employers can publish one combined feed for the counties their people live in.

Open data, no key

Cacheable public endpoints. Please cache and be gentle; whole-state exports are rate-limited.

GET /embed/{ocd_id}: A jurisdiction with its upcoming and past elections and contests (CORS open).
GET /elections/calendar?from=&to=&state=: Every election and deadline in a window, nationwide or per state.
GET /elections/{id}: One election with contests, candidates, results, and the claims behind each field.
GET /export/json/{ST}: Whole-state JSON dump of elections, contests and candidates.
GET /export/vip/{ST}.xml: Whole-state feed in a VIP 5-style XML shape.
GET /stats and /stats/scorecard: Coverage totals and the daily per-state freshness scorecard.

Base URL https://api.everyelection.app. Jurisdictions use Open Civic Data division ids.

Keyed API

Address lookups and bulk election queries for apps, with a per-key rate limit.

curl -H "x-api-key: $KEY" -X POST https://api.everyelection.app/v1/resolve \
     -H "content-type: application/json" -d '{"address":"201 W Gray St, Norman, OK"}'

curl -H "x-api-key: $KEY" "https://api.everyelection.app/v1/elections?division_ids=ocd-division/country:us/state:ok/county:cleveland"

Keys are issued on request. Request one with a line about what you are building.

Attribution and ground rules

Keep it accurate and keep it neutral.

Credit “Every Election” with a link, and keep links to official sources.
Do not present the data as an endorsement, or as official election-office records.
Details in the terms of use and editorial policy.

<div data-every-election="ocd-division/country:us/state:ok/county:cleveland" data-theme="auto" data-limit="3"></div> <script async src="https://everyelection.app/embed.js" data-api="https://api.everyelection.app" data-site="https://everyelection.app"></script>

https://api.everyelection.app/ics/division/ocd-division/country:us/state:ok/county:cleveland.ics https://api.everyelection.app/ics/divisions/{ocd_id},{ocd_id},….ics (up to 40 jurisdictions) https://api.everyelection.app/ics/election/{id}.ics

curl -H "x-api-key: $KEY" -X POST https://api.everyelection.app/v1/resolve \ -H "content-type: application/json" -d '{"address":"201 W Gray St, Norman, OK"}' curl -H "x-api-key: $KEY" "https://api.everyelection.app/v1/elections?division_ids=ocd-division/country:us/state:ok/county:cleveland"