mocop
Browse · Docs · Guide · Analyze

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
About · Contact · Privacy