What you get

• For each election we cover, our data coverage includes: candidate names, party affiliation for partisan offices, contact information, websites, and social media handles.
• Elections within our coverage include:
  • Primary elections for federal and state contests, as well as most major U.S. cities.
  • The November general election and general elections outside of November for federal and state contests, all counties, and most major U.S. cities.
  • Runoff elections for federal and state contests.
  • Special primary and special general elections for federal and state contests, as well as most major U.S. cities.

How we source our data and keep it up to date

• The Ballot Information Project dataset is sourced directly from state and local election officials, and then put in a standardized format.
• CTCL collects and updates ballot data at several inflection points in the candidacy process, including filing deadlines, withdrawal deadlines, and sample ballot availability.
• The Ballot Information Project also undergoes both manual and automated quality assurance checks to ensure internal consistency and data accuracy. These quality assurance checks include automated validations to ensure data is properly and consistently formatted, manual checks to ensure our coverage of candidates and contests is comprehensive, and sample ballot verifications for high-profile contests.

How to access our data

• Our Ballot Information Project data is available in Google’s Civic Information API.
• We also provide our Ballot Information Project data through our own API (in JSON format, where users can query by address and a particular election similar to the Google Civic Info API’s voterInfoQuery), as well as XML or tab-delimited .txt files.
• If you’re interested in obtaining our data, please reach out to us here.