Citizenbase API

Retrieve state election calendars, get sample ballots for a given address, and more.

Addresses

Endpoint: /address

Parameters: address, sessiontoken

Test it out

Districts

Endpoint: /districts

Parameters: address, include_offices

Test it out

Ballots by Ballotpedia

Endpoint: /ballot

Parameters: ocdID

Test it out

Ballots by BallotReady

Endpoint: /ballots

Parameters: address

Test it out

Create Personal Ballot

Endpoint: /myballot

Parameters: (address OR districts) AND (twitter OR name)

Methods: POST

Get Personal Ballot

Endpoint: /myballot

Parameters: uuid OR (twitter AND index)

Methods: GET

Test it out

Checklists

Endpoint: /checklist

Parameters: state

Test it out

Candidates

Endpoint: /candidate/<id>

Parameters: none

Test it out

Tweets

Endpoint: /twitter/tweet/<tweet_id>

Parameters: none

Test it out

Twitter Users

Endpoint: /twitter/user/<username>

Parameters: none

Test it out