BallotData API
API by BallotData · rest
Ballot races (elections, contests and their choices), endorsers and endorsements across the U.S., who holds office now, and a stream of endorsement changes. Everything is JSON over HTTPS. Send your API key on every request as Authorization: Bearer ebk_…. Lists are paged: { "data": [...], "next_cursor": "…" }; pass cursor for the next page. Every read takes fields to return only the fields you name, nested ones included: fields=id,title,choices(label,party) (guide: /docs/fields). Errors are { "error": { "code", "message", "request_id" } }. To find the ballot at an address, send it to POST /v1/ballot; the address is used for that request only and never stored.
Endpoint: https://api.ballotdata.ai/
Verification: observed. Source: crawl.
Capabilities (39)
- Look up the ballot at an address
- List candidates
- Get a candidate with endorsements
- List changes since a time
- Changes as an Atom 1.0 feed
- Changes as an RSS 2.0 feed
- List committee contributions
- List contests
- Get a contest with endorsements
- Coverage by state
- List elections
- Download a whole election
- List endorsements
- Get an endorsement
- Get an endorsement’s history
- List endorser categories
- List endorsers
- Get an endorser
- Compare an endorser with others
- Get an endorser’s track record
- Poll endorsement changes
- List issue positions
- List issues
- List measure topics
- List office terms