Democracy Works

This endpoint includes all statewide and local authorities that correspond to a given address or state parameter. The statewide authorities include evergreen information and guidance on how to register and vote in that state, as well as contact information for state election authorities. Local authorities provide contact information for the local election office. Authorities do not contain election-specific information such as dates, and while we closely monitor this data for changes and update when needed, Authorities information generally does not change from election to election. Authorities are returned sorted alphabetically by OCD-ID. Supports the following standard parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__, __[Localization](#section/Standard-Parameters/Localization)__, and __[Content Formatting](#section/Standard-Parameters/Content-Formatting)__.

Information on the ballot measures on the ballot, including a summary and the full text of the ballot measure.

This endpoint gets one candidate by `id`.

This endpoint gets one contest by `id`.

This endpoint has election-specific dates and deadlines, URLs for voters to get more information and take action, and detailed guidance in both English and Spanish. The information included reflects the voter registration and voting methods available in the state for that election, such as online, in-person, and by-mail registration as well as by-mail, in-person, and early voting. The election also contains some information from the related state authority. The default is to return all elections, though you can limit the response to upcoming elections through the use of the start date parameter. Elections are returned sorted chronologically by election date. After an election is confirmed to be occurring, Democracy Works surfaces information about an election as details become available. An election’s guidance phase describes the state of the currently available guidance. A `past` election is an election whose election date is in the past. An `expected` election is an upcoming election that is expected to occur but for which Democracy Works has not yet published specific guidance for. A `not currently expected` election is an election that Democracy Works expect to happen but will not publish guidance for. An `active` election is an upcoming election for which Democracy Works has published specific guidance. Elections are returned sorted chronologically by election date. Supports the following standard parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__, __[Localization](#section/Standard-Parameters/Localization)__, __[Content Formatting](#section/Standard-Parameters/Content-Formatting)__, and __[Fields](#section/Standard-Parameters/Fields)__. ### Ballot Measure Information Information about measures on the ballot will include: - All federal ballot measures - All statewide ballot measures - Local ballot measures in the top 100 cities by population Ballot measure information is not included in the default response for an election. For ballot measure information to be included with the response, include the `includeBallotData` parameter with a value of `true`. Ballot data is sourced from [Ballotpedia](https://ballotpedia.org/Election_coverage_approach_for_Ballotpedia). ### Candidate and Contest Information Information about contests and candidates on the ballot will include: - All federal contests and candidates, including senate and house of representatives - All state contests and candidates, including governor, treasurer, secretary of state, state legislative seats, state supreme court, district court, and court of appeals - Local contests and candidates including mayor, county judge, county clerk, commissioners, and city councils in the top 100 cities by population, plus school board elections in 475 districts - Note that local coverage may be limited by mapping constraints. Ballot data is sourced from [Ballotpedia](https://ballotpedia.org/Election_coverage_approach_for_Ballotpedia).

This endpoint gets one endorsement by `endorsement id`.

This endpoint a list of endorsements by ballot measure or candidate id. You may not provide an ballot measure and candidate id at the same time. No endorsement is associated with both a ballot measure & candidate. Supports the following standard parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__.

This endpoint serves presigned URLs to flat files on AWS S3. It supports no parameters. To set up a bulk data export, contact partnerships@democracy.works. Presigned URLs are temporary and expire after one hour. Download the file promptly after requesting a URL. If a URL expires before you can download your file, request a new one from this endpoint. Presigned URLs grant access to your data. Do not share these URLs with any party that should have access to this data. [Learn more about Working with presigned URLs on AWS](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-presigned-url.html).

This endpoint provides contact information for over 8,500 local election offices at the county and municipal levels. Authorities are returned sorted alphabetically by OCD-ID. Supports the following standard parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__ and __[Localization](#section/Standard-Parameters/Localization)__.

This endpoint includes statewide evergreen information and instructions on how to register and vote for each state (and Washington, D.C.). It includes contact information for state election authorities, registration methods, voting methods, state-specific URLs to authoritative government websites, and more. Authorities do not contain election-specific information such as dates, and while we closely monitor this data for changes and update when needed, Authorities information generally does not change from election to election. Authorities are returned sorted alphabetically by OCD-ID. Supports standard the following parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__, __[Localization](#section/Standard-Parameters/Localization)__, and __[Content Formatting](#section/Standard-Parameters/Content-Formatting)__.

### Address arguments An address may be supplied in one of two ways: - **As a single string**, via `address`. - **As components**, via `addressStreet`, `addressCity`, `addressState`, and `addressZip`. All four component parameters must be present, and `addressUnitNumber` may optionally be added. All requests must include an address as single string or with all required components (preferred). ```bash # Address as a single string curl \ --get \ --header "X-API-KEY: $YOUR_API_KEY" \ --data-urlencode address="20 Jay Street Brooklyn NY 11201" \ --data-urlencode publishStatus=prepublished \ https://api.democracy.works/v2/voting-locations ``` ```bash # Address as components curl \ --get \ --header "X-API-KEY: $YOUR_API_KEY" \ --data-urlencode addressStreet="20 Jay Street" \ --data-urlencode addressCity=Brooklyn \ --data-urlencode addressState=NY \ --data-urlencode addressZip=11201 \ --data-urlencode addressUnitNumber="Unit 410" \ --data-urlencode publishStatus=prepublished \ https://api.democracy.works/v2/voting-locations ```