{ "item": [ { "id": "a04be3df-6ad1-4839-8e1a-b299a4f531bf", "name": "Authorities", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "bfd7e195-fe02-4736-812f-7ce7b3dca1e9", "name": "State authorities", "request": { "name": "State authorities", "description": { "content": "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. \n\nAuthorities 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.\n\nAuthorities are returned sorted alphabetically by OCD-ID. \n\nSupports standard the following parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__, __[Localization](#section/Standard-Parameters/Localization)__, and __[Content Formatting](#section/Standard-Parameters/Content-Formatting)__.\n", "type": "text/plain" }, "url": { "path": [ "authorities", "state", ":stateCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "includeQuestionAndAnswer", "value": "" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "stateCode" } ] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "d35c9cd5-b27f-4b6b-9949-8aeb0167bbbd", "name": "Authorities fetched by query.", "originalRequest": { "url": { "path": [ "authorities", "state", ":stateCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "stateCode" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"authorities\": [\n {\n \"ocdId\": \"ocd-division/country:us/state:al\",\n \"officeName\": \"Alabama\",\n \"officialTitle\": \"Office of the Secretary of State\",\n \"homepageUrl\": \"https://sos.alabama.gov/alabama-votes\",\n \"pollingLocationUrl\": \"https://myinfo.alabamavotes.gov/voterview\",\n \"votingWithDisabilitiesUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/assistance-disability\",\n \"votingWithPastConvictionsUrl\": \"https://www.sos.alabama.gov/sites/default/files/Voting-Rights-Final-Version.pdf\",\n \"canonicalUrl\": \"https://staging.voting.democracy.works/en/vote/al.html\",\n \"partyInstructions\": \"If you choose not to declare a political preference at the primary election, you will not be eligible to vote in any political partys primary election. You are, however, still eligible to vote on any proposed constitutional amendments that are up for a vote.\",\n \"updatedAt\": \"2023-12-05T10:05:43.853825+00:00\",\n \"timezone\": \"Central\",\n \"secondaryTimezone\": \"Eastern\",\n \"localElectionAuthorityOfficeAlias\": \"Absentee Election Manager\",\n \"separateRegistrationAndElectionAuthorities\": true,\n \"localElectionAuthorityName\": \"Local Authority\",\n \"localRegistrationAuthorityName\": \"Board of Registrars\",\n \"localRegistrationAuthorityLookupUrl\": \"https://www.sos.alabama.gov/city-county-lookup/bor\",\n \"localElectionAuthorityLookupUrl\": \"https://www.sos.alabama.gov/city-county-lookup/absentee-election-manager\",\n \"registrationAuthorityLevel\": \"county\",\n \"electionAuthorityLevel\": \"county\",\n \"contact\": {\n \"phone\": \"(334) 242-7210\",\n \"email\": \"alavoter@vote.alabama.gov\",\n \"physicalAddress\": {\n \"street\": \"600 Dexter Ave, Suite E-206\",\n \"city\": \"Montgomery\",\n \"state\": \"AL\",\n \"zip\": \"36130\"\n },\n \"mailingAddress\": {\n \"street\": \"P. O. Box 5616\",\n \"city\": \"Montgomery\",\n \"state\": \"AL\",\n \"zip\": \"36103-5616\"\n }\n },\n \"voting\": {\n \"inPersonVotingAvailable\": true,\n \"mailBallotsSentAutomatically\": false,\n \"inPerson\": {\n \"idRequiredAllVoters\": true,\n \"idInstructions\": \"You will need to show photo ID to vote in Alabama.
Acceptable\\nforms of valid photo ID include: Alabama driver's license (may be expired up\\nto 60 days); Alabama non-driver's ID card (may be expired up to 60 days); Alabama\\nphoto voter ID card; digital driver's license or non-driver ID issued by the\\nAlabama Law Enforcement Agency; photo ID card issued by Alabama or any other\\nstate (examples include AL Department of Corrections Release - Temporary ID,\\nAL Movement/Booking Sheet from Prison/Jail System, or a pistol permit); federal\\ngovernment issued ID; US passport; employee ID card issued by the federal government,\\nthe State of Alabama, county, municipality, board or other entity in Alabama;\\nstudent or employee ID issued by a public or private college or university in\\nAlabama; US military ID; valid tribal ID

Voters without ID: If you are\\nunable to provide ID, you will be able to vote a provisional ballot. In order\\nfor your ballot to be counted, you must provide your ID, including your address\\nand your telephone number, to the board of registrars no later than 5:00 P.M.\\non the Friday following the election. If you fail to provide ID to the board\\nof registrars by that time, your ballot will not be counted. In addition, voters\\nwho do not show valid photo ID at the polls can vote a regular ballot if they\\nare positively identified by two election officials as a voter on the poll list\\nwho is eligible to vote and the election officials sign a sworn affidavit.\\n\"\n },\n \"early\": {\n \"supported\": false,\n \"excuseRequired\": false,\n \"alias\": \"early vote\"\n },\n \"byMail\": {\n \"ballotApplicationOnline\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"returnByMailUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"eligibilityUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"returnInPersonUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"excuseRequired\": true,\n \"excuses\": [\n {\n \"excuse\": \"absence\",\n \"example\": \"I expect to be out of the county or the state on election day.\"\n },\n {\n \"excuse\": \"illnessDisability\",\n \"example\": \"I am physically incapacitated and will not be able to vote in person on election day.\"\n },\n {\n \"excuse\": \"illnessAgeDisability\",\n \"example\": \"I have a physical illness or infirmity which prevents my attendance at the polls. I am unable to access my assigned polling place due to a neurological, musculoskeletal, respiratory (including speech organs), cardiovascular, or other life-altering disorder that affects my ability to perform manual tasks, stand for any length of time, walk unassisted, see, hear or speak and: \\ra) I am an elderly voter aged 65 or older; or \\rb) I am a voter with a disability.\"\n },\n {\n \"excuse\": \"employment\",\n \"example\": \"I expect to work a shift which has at least ten (10) hours that coincide with the polling hours at my regular polling place.\"\n },\n {\n \"excuse\": \"student\",\n \"example\": \"I am enrolled as a student at an educational institution located outside the county of my personal residence and am therefore unable to vote at my usual polling place on election day.\"\n },\n {\n \"excuse\": \"uocava\",\n \"example\": \"I am a member of, or a spouse or dependent of a member of, the Armed Forces of the United States or am otherwise similarly qualified to vote absentee pursuant to the Uniformed and Overseas Citizens Absentee Voting Act, 52 U.S.C. � 20302.\"\n },\n {\n \"excuse\": \"electionWorker\",\n \"example\": \"I have been appointed as an election officer at a polling place which is not my regular polling place.\"\n },\n {\n \"excuse\": \"caregiver\",\n \"example\": \"I am a caregiver for a family member to the second degree of kinship by affinity or consanguinity and the family member is confined to his or her home.\"\n },\n {\n \"excuse\": \"incarcerated\",\n \"example\": \"I am currently incarcerated in prison or jail and have not been convicted of a felony involving moral turpitude.\"\n }\n ],\n \"ballotTrackingUrl\": \"https://myinfo.alabamavotes.gov/voterview\",\n \"ballotApplicationDownload\": \"https://www.sos.alabama.gov/alabama-votes/absentee-ballot-applications\",\n \"idInstructions\": \"ID is required for all voters.\",\n \"alias\": \"absentee\"\n }\n },\n \"registration\": {\n \"statusUrl\": \"https://myinfo.alabamavotes.gov/voterview\",\n \"formUrl\": \"https://www.sos.alabama.gov/sites/default/files/voter-pdfs/nvra-2.pdf\",\n \"noRegistrationRequiredInstructions\": \"You cannot vote without valid registration.\",\n \"methods\": [\n \"byMail\",\n \"online\"\n ],\n \"byMail\": {\n \"supported\": true,\n \"url\": \"https://www.sos.alabama.gov/alabama-votes/voter/register-to-vote\",\n \"forms\": \"nvrf\",\n \"raceFieldRequired\": false,\n \"raceFieldInstructions\": \"You are required to fill in this box; however, your application will not be rejected if you fail to do so.\",\n \"idInstructions\": \"If you have one, you must provide your Alabama driver's license number or Alabama non-driver's identification card number. If you do not have an Alabama driver's license or non-driver's identification card, you must provide the last four digits of your Social Security number. If you have not been issued any of these numbers you must write the word \\\"NONE\\\" and a unique identifier will be provided for you.\",\n \"signatureInstructions\": \"To register in Alabama you must:
be a citizen of the United States
be a resident of Alabama and your county at the time of registration
be 18 years old on or before Election Day
not be barred from voting by reason of a disqualifying felony conviction, or if you have been convicted, you must have had your civil rights restored. You can find the list of disqualifying felonies on the Secretary of States website here at: sos.alabama.gov/mtfelonies
not have been declared mentally incompetent in a court
swear or affirm to \\\"support and defend the Constitution of the U.S. and the State of Alabama and further disavow any belief or affiliation with any group which advocates the overthrow of the governments of the U.S. or the State of Alabama by unlawful means and that the information contained herein is true\\\"\",\n \"citizenInstructions\": \"You must be a citizen to vote in Alabama.\",\n \"newVoterInstructions\": \"If you are registering to vote for the first time in your jurisdiction and are mailing this registration application, federal law requires you to show proof of identification the first time you vote. Proof of identification includes: current and valid photo identification or current utility bill, bank statement, government check, paycheck or government document that shows your name and address.
More information here.\"\n },\n \"online\": {\n \"supported\": true,\n \"instructions\": \"You should know: you need an Alabama driver's license or non-driver\\nID to use Alabama's online voter registration system. If you don't have an\\nAlabama-issued ID, you can still register by mail to vote.\\n\",\n \"url\": \"https://www.alabamainteractive.org/sos/voter_registration/voterRegistrationWelcome.action\"\n },\n \"inPerson\": {\n \"supported\": false,\n \"electionDayInstructions\": \"You cannot register to vote in person on Election Day in Alabama.\",\n \"advanceUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter-registration/general-info?_ga=2.13156215.1931915915.1655313501-640998901.1644592274\"\n }\n },\n \"youthRegistration\": {\n \"url\": \"https://www.sos.alabama.gov/alabama-votes/youth-voter-registration\",\n \"formUrl\": \"https://www.sos.alabama.gov/alabama-votes/youth-voter-registration\",\n \"supported\": \"byElection\",\n \"methods\": \"online,by-mail,in-person\",\n \"onlineInstructions\": \"To register using the Alabama online voter registration system,\\nyou are required to provide ONE of the following valid ID numbers: Alabama Driver's\\nLicense; Alabama Non-Driver's Identification card

If you dont have an\\nAlabama-issued ID, you can still submit a voter registration application by mail\\nor in person.\\n\",\n \"inPersonInstructions\": \"You can complete a voter registration application in person at your local County Board of Registrars in Alabama.

You can also obtain a voter registration application in person at any of the following public agencies in Alabama: driver's licensing office; county and select municipal public libraries; public four-year universities and select private four-year universities

You can find a list of locations that provide voter registration services and voter registration application on the Alabama Secretary of States website.\",\n \"byMailInstructions\": \"When submitting your application by mail in Alabama, you are required to provide your Alabama Drivers License number or Alabama Non-Driver ID number. If you do not have one, you are required to provide the last four digits of your Social Security number. If you have not been issued any of these numbers, check the box that indicates you do not have an ID number. You may send with your application a copy of your valid photo ID.\",\n \"eligibilityAge\": \"18\",\n \"statusAvailability\": \"Unknown\"\n },\n \"questionAndAnswer\": {\n \"whoCanVote\": {\n \"question\": \"Who can register to vote?\",\n \"answer\": \"
To register in Alabama you must:
  • be a citizen of the United States
  • be a resident of Alabama and your county at the time of registration
  • be 18 years old on or before Election Day
  • not be barred from voting by reason of a disqualifying felony conviction, or if you have been convicted, you must have had your civil rights restored. You can find the list of disqualifying felonies on the Secretary of States website here at: sos.alabama.gov/mtfelonies
  • not have been declared mentally incompetent in a court
  • swear or affirm to \\\"support and defend the Constitution of the U.S. and the State of Alabama and further disavow any belief or affiliation with any group which advocates the overthrow of the governments of the U.S. or the State of Alabama by unlawful means and that the information contained herein is true\\\"
\"\n },\n \"byMailRegistration\": {\n \"question\": \"Can I submit voter registration forms by mail?\",\n \"answer\": \"

Use the National Voter Registration Form

  1. Print and fill out the National Voter Registration Form.
  2. Box 6 - ID Number: If you have one, you must provide your Alabama driver's license number or Alabama non-driver's identification card number. If you do not have an Alabama driver's license or non-driver's identification card, you must provide the last four digits of your Social Security number. If you have not been issued any of these numbers you must write the word \\\"NONE\\\" and a unique identifier will be provided for you.
  3. Box 7 - Choice of Party: If you choose not to declare a political preference at the primary election, you will not be eligible to vote in any political partys primary election. You are, however, still eligible to vote on any proposed constitutional amendments that are up for a vote.
  4. Box 8 - Race or Ethnic Group: You are required to fill in this box; however, your application will not be rejected if you fail to do so.
  5. Review the \\\"Who can register to vote?\\\" section above and check that you're eligible.
  6. Sign the form.
  7. Send the completed form to your Board of Registrars
  8. If you are registering to vote for the first time in your jurisdiction and are mailing this registration application, federal law requires you to show proof of identification the first time you vote. Proof of identification includes: current and valid photo identification or current utility bill, bank statement, government check, paycheck or government document that shows your name and address.
    • More information here.
\"\n },\n \"electionDayRegistration\": {\n \"question\": \"Can I register to vote on Election Day?\",\n \"answer\": \"Alabama does not offer registration on Election Day.\"\n },\n \"inPersonRegistration\": {\n \"question\": \"Can I submit voter registration forms in person?\",\n \"answer\": \"\"\n },\n \"youthRegistrationEligibility\": {\n \"question\": \"Can I register to vote before I turn 18?\",\n \"answer\": \" You can register to vote in Alabama before you turn 18 if you:
  • are at least 18 years old on or before Election Day
  • are a citizen of the United States
  • live in Alabama
  • have not been convicted of a disqualifying felony (or have had rights restored)
  • have not been legally declared \\\"mentally incompetent\\\" by a court

You must be at least 18 years old to vote.
\"\n },\n \"youthInPersonRegistration\": {\n \"question\": \"Can I complete a voter registration application in person before I turn 18?\",\n \"answer\": \"Yes, you can learn more about registering to vote in person on the Alabama Office of the Secretary of State website. You can complete a voter registration application in person at your local County Board of Registrars in Alabama.
You can also obtain a voter registration application in person at any of the following public agencies in Alabama:
  • driver's licensing office
  • county and select municipal public libraries
  • public four-year universities and select private four-year universities

You can find a list of locations that provide voter registration services and voter registration application on the Alabama Secretary of States website.\"\n },\n \"youthOnlineVoterRegistration\": {\n \"question\": \"Can I submit a voter registration application online before I turn 18?\",\n \"answer\": \" Yes, you can register online on the Alabama Office of the Secretary of State website. To register using the Alabama online voter registration system, you are required to provide ONE of the following valid ID numbers:
  • Alabama Driver's License
  • Alabama Non-Driver's Identification card

If you dont have an Alabama-issued ID, you can still submit a voter registration application by mail or in person. \"\n },\n \"youthByMailRegistration\": {\n \"question\": \"Can I submit a voter registration application by mail before I turn 18?\",\n \"answer\": \" Yes, you can register to vote by mail using this form. When submitting your application by mail in Alabama, you are required to provide your Alabama Drivers License number or Alabama Non-Driver ID number. If you do not have one, you are required to provide the last four digits of your Social Security number. If you have not been issued any of these numbers, check the box that indicates you do not have an ID number. You may send with your application a copy of your valid photo ID. \"\n },\n \"militaryAndOverseas\": {\n \"question\": \"How do I vote if I'm in the military or live overseas?\",\n \"answer\": \"
Active-duty military, their families, and overseas citizens can register to vote and request their absentee ballot using the Federal Post Card Application (FPCA). The FPCA process is done by mail, but your state may offer other options to request and return ballots. Please contact your Absentee Election Manager for more information about delivery and return methods, including email, fax, and state online portals. To follow the FPCA process:
  1. Fill out the Federal Post Card Application (FPCA), or download a copy. Your Absentee Election Manager may have questions, so please provide an email address or phone number where they can reach you.
  2. Send the application to your Absentee Election Manager.
  3. It is never too early to submit an FPCA! Please do so as soon as possible.
  4. Please fill out and send back your ballot as soon as you receive it.
  5. States begin mailing absentee ballots at least 45 days before Election Day. If you haven't received your ballot by 30 days before Election Day, contact your Absentee Election Manager.
If after submitting your FPCA, your ballot does not arrive, contact your Absentee Election Manager first. Then:
  • You can still vote using the Federal Write-In Absentee Ballot (FWAB). Print, sign, and mail your FWAB to your Absentee Election Manager.
  • If you mail a FWAB and then receive your regular absentee ballot, you should complete and mail your absentee ballot also. Election officials will ensure that only one ballot is counted.
The Federal Voting Assistance Program offers additional information on military and overseas voting in Alabama. You can also call 1-800-438-VOTE (8683) or email vote@fvap.gov
\"\n },\n \"checkRegistration\": {\n \"question\": \"How can I check my voter registration status?\",\n \"answer\": \"You can look up your voter registration record and verify that your information is correct using Alabama's voter registration lookup tool.\"\n },\n \"contactElectionOffice\": {\n \"question\": \"Which election office should I contact?\",\n \"answer\": \"
  • In Alabama, the Board of Registrars and Absentee Election Manager run voter registration and elections in your area. The Board of Registrars can help you with questions about registering to vote, and the Absentee Election Manager can help you with questions about voting, including voting by mail.
  • The Office of the Secretary of State oversees elections and election administration in Alabama. They can help you with questions about voting in your state, election security, or issues you might have at the polls. If you have concerns about voter intimidation, reach out immediately.
\"\n },\n \"localContactInfo\": {\n \"question\": \"How do I contact my local election office?\",\n \"answer\": \"Visit your states site to find the contact information for the Board of Registrars or the Absentee Election Manager. \"\n },\n \"stateContactInfo\": {\n \"question\": \"How do I contact my state election office?\",\n \"answer\": \"
Office of the Secretary of State
\"\n },\n \"voteInPerson\": {\n \"question\": \"How do I vote in person?\",\n \"answer\": \"

Where can I vote on Election Day?

You can look up where to vote on Alabama's site.

Can I vote early?

No, early voting in person before Election Day is not offered in this election. Alabama does offer absentee voting with an excuse in-person or by mail beginning 55 days prior to Election Day. Find the eligibility requirements for absentee voting and contact your Absentee Election Manager to check if you can visit their office to request and return an absentee ballot in person.

What do I need to bring?

You will need to show photo ID to vote in Alabama.

Acceptable forms of valid photo ID include:
  • Alabama driver's license (may be expired up to 60 days)
  • Alabama non-driver's ID card (may be expired up to 60 days)
  • Alabama photo voter ID card
  • digital driver's license or non-driver ID issued by the Alabama Law Enforcement Agency
  • photo ID card issued by Alabama or any other state (examples include AL Department of Corrections Release - Temporary ID, AL Movement/Booking Sheet from Prison/Jail System, or a pistol permit)
  • federal government issued ID
  • US passport
  • employee ID card issued by the federal government, the State of Alabama, county, municipality, board or other entity in Alabama
  • student or employee ID issued by a public or private college or university in Alabama
  • US military ID
  • valid tribal ID

Voters without ID: If you are unable to provide ID, you will be able to vote a provisional ballot. In order for your ballot to be counted, you must provide your ID, including your address and your telephone number, to the board of registrars no later than 5:00 P.M. on the Friday following the election. If you fail to provide ID to the board of registrars by that time, your ballot will not be counted. In addition, voters who do not show valid photo ID at the polls can vote a regular ballot if they are positively identified by two election officials as a voter on the poll list who is eligible to vote and the election officials sign a sworn affidavit.

How can I check the status of my ballot?

You can check the status of your ballot on Alabamas site.
\"\n },\n \"voteByMail\": {\n \"question\": \"How do I vote by mail?\",\n \"answer\": \"
Alabama allows eligible voters to request a mail ballot. All other voters are expected to vote in person. Check to see if youre eligible to vote by mail on Alabama's site.

How do I get my ballot?

Request your mail-in ballot with a mail ballot application.

What should I do if I dont get my ballot?

If you dont receive your ballot in the mail, then contact your Absentee Election Manager.

How do I return my ballot?

What do I need to do if Ive moved?

Whats on your ballot depends on where you live, so your voter registration is tied to your exact address. If youve moved, you need to re-register with your new address.

How can I check the status of my ballot?

You can check the status of your ballot on Alabamas site.
\"\n },\n \"whatsOnTheBallot\": {\n \"question\": \"How do I see what's on my ballot?\",\n \"answer\": \"Learn more about what will be on your ballot by visiting the Alabama website.\"\n }\n }\n },\n {\n \"ocdId\": \"ocd-division/country:us/state:co\",\n \"officeName\": \"Colorado\",\n \"officialTitle\": \"Secretary of State\",\n \"homepageUrl\": \"https://www.coloradosos.gov/voter/pages/pub/home.xhtml\",\n \"pollingLocationUrl\": \"https://www.sos.state.co.us/pubs/elections/VIP.html\",\n \"studentVotingUrl\": \"https://www.sos.state.co.us/pubs/elections/FAQs/college.html\",\n \"votingWithDisabilitiesUrl\": \"https://www.sos.state.co.us/pubs/elections/FAQs/ElectorsWithDisabilities.html\",\n \"votingWithPastConvictionsUrl\": \"https://www.coloradosos.gov/pubs/elections/FAQs/VotingAndConviction.html\",\n \"canonicalUrl\": \"https://staging.voting.democracy.works/en/vote/co.html\",\n \"partyInstructions\": \"You are NOT required to register with a party to participate in Colorado partisan primary elections. If you do not register with a party, you may choose the party primary you wish to vote in. If you choose to register with a party, you can only vote in that party's primary. If you are an unaffiliated voter and return a ballot with more than one political party, the ballot will be rejected and none of the votes will be counted.\",\n \"updatedAt\": \"2023-12-05T19:40:03.797005+00:00\",\n \"timezone\": \"Mountain\",\n \"secondaryTimezone\": null,\n \"localElectionAuthorityOfficeAlias\": null,\n \"separateRegistrationAndElectionAuthorities\": null,\n \"localElectionAuthorityName\": null,\n \"localRegistrationAuthorityName\": null,\n \"localRegistrationAuthorityLookupUrl\": \"https://www.coloradosos.gov/pubs/elections/Resources/CountyElectionOffices.html\",\n \"localElectionAuthorityLookupUrl\": \"https://www.coloradosos.gov/pubs/elections/Resources/CountyElectionOffices.html\",\n \"registrationAuthorityLevel\": \"county\",\n \"electionAuthorityLevel\": \"county\",\n \"contact\": {\n \"phone\": \"(303) 894-2200\",\n \"email\": \"elections@coloradosos.gov\",\n \"physicalAddress\": {\n \"street\": \"1700 Broadway, Suite 550\",\n \"city\": \"Denver\",\n \"state\": \"CO\",\n \"zip\": \"80290\"\n },\n \"mailingAddress\": {\n \"street\": \"Elections and Voting, 1700 Broadway, Suite 550\",\n \"city\": \"Denver\",\n \"state\": \"CO\",\n \"zip\": \"80290\"\n }\n },\n \"voting\": {\n \"inPersonVotingAvailable\": true,\n \"mailBallotsSentAutomatically\": true,\n \"inPerson\": {\n \"idRequiredAllVoters\": true,\n \"idInstructions\": \"If you choose to vote in person in Colorado, you will need to\\nshow ID. If your form of identification shows your address, that address must\\nbe in the state of Colorado.

Acceptable forms include: Colorado driver's\\nlicense; valid ID card issued by the Colorado Department of Revenue; US passport;\\nemployee ID with photo issued by any entity of the US government or Colorado;\\npilot's license issued by the FAA or other authorized agency of the US; US\\nmilitary ID with photo; ID card issued by a federally recognized tribal government;\\nMedicare or Medicaid card; certified copy of your US birth certificate; certificate\\nof Degree of Indian or Alaskan Native Blood; certified documentation of naturalization;\\nstudent ID with photo issued by a Colorado institute of higher education; veteran's\\nID with photo issued by the VA; current utility bill, bank statement, government\\ncheck, paycheck, or other government document showing name and address (within\\nlast 60 days)

Voters without ID: If you are unable to provide ID, you\\nwill be able to vote a provisional ballot, or you may request a mail ballot\\nto take home, sign, and return to your county clerk. Your signature is used\\nto verify your identity on a mail ballot.\\n\"\n },\n \"early\": {\n \"supported\": true,\n \"excuseRequired\": false,\n \"alias\": null\n },\n \"byMail\": {\n \"ballotApplicationOnline\": null,\n \"returnByMailUrl\": \"https://www.coloradosos.gov/pubs/elections/FAQs/mailBallotsFAQ.html\",\n \"eligibilityUrl\": \"https://www.coloradosos.gov/pubs/elections/FAQs/mailBallotsFAQ.html\",\n \"returnInPersonUrl\": \"https://www.coloradosos.gov/pubs/elections/FAQs/mailBallotsFAQ.html\",\n \"excuseRequired\": null,\n \"excuses\": [],\n \"ballotTrackingUrl\": \"https://ballottrax.coloradosos.gov/voter/\",\n \"ballotApplicationDownload\": \"https://www.coloradosos.gov/voter/pages/pub/olvr/findVoterReg.xhtml\",\n \"idInstructions\": null,\n \"alias\": \"mail\"\n }\n },\n \"registration\": {\n \"statusUrl\": \"https://www.coloradosos.gov/voter/pages/pub/olvr/findVoterReg.xhtml\",\n \"formUrl\": \"https://www.coloradosos.gov/pubs/elections/vote/VoterRegFormEnglish.pdf\",\n \"noRegistrationRequiredInstructions\": null,\n \"methods\": [\n \"byMail\",\n \"online\",\n \"electionDay\"\n ],\n \"byMail\": {\n \"supported\": true,\n \"url\": \"https://www.coloradosos.gov/pubs/elections/FAQs/VoterRegistrationFAQ.html\",\n \"forms\": \"nvrf\",\n \"raceFieldRequired\": null,\n \"raceFieldInstructions\": null,\n \"idInstructions\": \"Your completed voter registration form must contain your Colorado driver's license number or identification card number. If you do not have a driver's license or Colorado-issued ID, you must include the last four digits of your Social Security number. If you do not have a Colorado driver's license or a Colorado-issued identification or a Social Security number, please write \\\"NONE\\\" on the form. A unique identifying number will be assigned by the State.\",\n \"signatureInstructions\": \"To register in Colorado you must:
be a citizen of the United States
be a resident of Colorado for at least 22 days immediately before the election in which you intend to vote
be at least 16 years old, and you must be at least 18 on or before election day to be eligible to vote
not be serving a sentence of detention or confinement for a felony conviction\",\n \"citizenInstructions\": null,\n \"newVoterInstructions\": \"If you are registering to vote for the first time in your jurisdiction and are mailing this registration application, federal law requires you to show proof of identification the first time you vote. Proof of identification includes current and valid photo identification OR current utility bill, bank statement, government check, paycheck or government document that shows your name and address. More information here.\"\n },\n \"online\": {\n \"supported\": true,\n \"instructions\": \"You should know: you need a Colorado driver's license, Colorado\\nID card, or valid Social Security number to use Colorado's online voter registration\\nsystem. If you don't have a Colorado-issued ID or Social Security number, you\\ncan still submit a voter registration application in person or by mail.\\n\",\n \"url\": \"https://www.coloradosos.gov/voter/pages/pub/olvr/verifyNewVoter.xhtml\"\n },\n \"inPerson\": {\n \"supported\": false,\n \"electionDayInstructions\": null,\n \"advanceUrl\": \"https://www.coloradosos.gov/pubs/elections/FAQs/VoterRegistrationFAQ.html\"\n }\n },\n \"youthRegistration\": {\n \"url\": \"https://www.sos.state.co.us/pubs/elections/highSchoolRegistration.html\",\n \"formUrl\": null,\n \"supported\": \"byAge\",\n \"methods\": \"online,by-mail,in-person\",\n \"onlineInstructions\": \"To register using the Colorado online voter registration system, you are required to provide at least ONE of the following: Colorado drivers license number; Colorado ID card number; last four digits of your Social Security number

If you dont have a Colorado Drivers License, Colorado ID card, or Social Security number, you can still submit a voter registration application in person or by mail.\",\n \"inPersonInstructions\": \"You can complete a voter registration application in person at any of the following public agencies in Colorado: Colorado Department of Motor Vehicle office when you apply for a driver's license or when updating your driver's license information; Colorado public high schools; county clerk and recorders office

You can also complete a voter registration application in person at any office that provides voter registration services and applications. You can find a full list on the Colorado Secretary of States website.\",\n \"byMailInstructions\": \"When submitting your application by mail in Colorado, you are required to provide your Colorado drivers license number or Colorado ID card number if you have one. If you have not been issued one of these ID numbers, you must provide the last four digits of your Social Security number.

If you have not been issued any of these numbers, check the box that indicates you do not have an ID number. You may be required to provide an acceptable form of ID the first time you vote in an election in Colorado. You can find a full list of acceptable forms of ID on the website.\",\n \"eligibilityAge\": \"P16Y\",\n \"statusAvailability\": \"Unknown\"\n },\n \"questionAndAnswer\": {\n \"whoCanVote\": {\n \"question\": \"Who can register to vote?\",\n \"answer\": \"
To register in Colorado you must:
  • be a citizen of the United States
  • be a resident of Colorado for at least 22 days immediately before the election in which you intend to vote
  • be at least 16 years old, and you must be at least 18 on or before election day to be eligible to vote
  • not be serving a sentence of detention or confinement for a felony conviction
\"\n },\n \"byMailRegistration\": {\n \"question\": \"Can I submit voter registration forms by mail?\",\n \"answer\": \"

Use the National Voter Registration Form

  1. Print and fill out the National Voter Registration Form.
  2. Box 6 - ID Number: Your completed voter registration form must contain your Colorado driver's license number or identification card number. If you do not have a driver's license or Colorado-issued ID, you must include the last four digits of your Social Security number. If you do not have a Colorado driver's license or a Colorado-issued identification or a Social Security number, please write \\\"NONE\\\" on the form. A unique identifying number will be assigned by the State.
  3. Box 7 - Choice of Party: You are NOT required to register with a party to participate in Colorado partisan primary elections. If you do not register with a party, you may choose the party primary you wish to vote in. If you choose to register with a party, you can only vote in that party's primary. If you are an unaffiliated voter and return a ballot with more than one political party, the ballot will be rejected and none of the votes will be counted.
  4. Box 8 - Race or Ethnic Group: Leave blank. This information is not required.
  5. Review the \\\"Who can register to vote?\\\" section above and check that you're eligible.
  6. Sign the form.
  7. Send the completed form to your local election office
  8. If you are registering to vote for the first time in your jurisdiction and are mailing this registration application, federal law requires you to show proof of identification the first time you vote. Proof of identification includes current and valid photo identification OR current utility bill, bank statement, government check, paycheck or government document that shows your name and address. More information here.
\"\n },\n \"electionDayRegistration\": {\n \"question\": \"Can I register to vote on Election Day?\",\n \"answer\": \"Colorado does offer in person registration on Election Day.\"\n },\n \"inPersonRegistration\": {\n \"question\": \"Can I submit voter registration forms in person?\",\n \"answer\": \"\"\n },\n \"youthRegistrationEligibility\": {\n \"question\": \"Can I register to vote before I turn 18?\",\n \"answer\": \" You can register to vote in Colorado before you turn 18 if you:
  • are at least 16 years old
  • are a citizen of the United States
  • will be a resident of Colorado for at least 22 days immediately before the election in which you plan to vote
  • are not currently serving a term of imprisonment for a felony conviction

You must be 18 years old to vote in an election.
\"\n },\n \"youthInPersonRegistration\": {\n \"question\": \"Can I complete a voter registration application in person before I turn 18?\",\n \"answer\": \"Yes, you can learn more about registering to vote in person on the Colorado Secretary of State website. You can complete a voter registration application in person at any of the following public agencies in Colorado:
  • Colorado Department of Motor Vehicle office when you apply for a driver's license or when updating your driver's license information
  • Colorado public high schools
  • county clerk and recorders office

You can also complete a voter registration application in person at any office that provides voter registration services and applications. You can find a full list on the Colorado Secretary of States website.\"\n },\n \"youthOnlineVoterRegistration\": {\n \"question\": \"Can I submit a voter registration application online before I turn 18?\",\n \"answer\": \" Yes, you can register online on the Colorado Secretary of State website. To register using the Colorado online voter registration system, you are required to provide at least ONE of the following:
  • Colorado drivers license number
  • Colorado ID card number
  • last four digits of your Social Security number

If you dont have a Colorado Drivers License, Colorado ID card, or Social Security number, you can still submit a voter registration application in person or by mail. \"\n },\n \"youthByMailRegistration\": {\n \"question\": \"Can I submit a voter registration application by mail before I turn 18?\",\n \"answer\": \" Yes, you can learn more about registering to vote by mail on the Colorado Secretary of State website. When submitting your application by mail in Colorado, you are required to provide your Colorado drivers license number or Colorado ID card number if you have one. If you have not been issued one of these ID numbers, you must provide the last four digits of your Social Security number.
If you have not been issued any of these numbers, check the box that indicates you do not have an ID number. You may be required to provide an acceptable form of ID the first time you vote in an election in Colorado. You can find a full list of acceptable forms of ID on the website. \"\n },\n \"militaryAndOverseas\": {\n \"question\": \"How do I vote if I'm in the military or live overseas?\",\n \"answer\": \"
Active-duty military, their families, and overseas citizens can register to vote and request their absentee ballot using the Federal Post Card Application (FPCA). The FPCA process is done by mail, but your state may offer other options to request and return ballots. Please contact your local election office for more information about delivery and return methods, including email, fax, and state online portals. To follow the FPCA process:
  1. Fill out the Federal Post Card Application (FPCA), or download a copy. Your local election office may have questions, so please provide an email address or phone number where they can reach you.
  2. Send the application to your local election office.
  3. It is never too early to submit an FPCA! Please do so as soon as possible.
  4. Please fill out and send back your ballot as soon as you receive it.
  5. States begin mailing absentee ballots at least 45 days before Election Day. If you haven't received your ballot by 30 days before Election Day, contact your local election office.
If after submitting your FPCA, your ballot does not arrive, contact your local election office first. Then:
  • You can still vote using the Federal Write-In Absentee Ballot (FWAB). Print, sign, and mail your FWAB to your local election office.
  • If you mail a FWAB and then receive your regular absentee ballot, you should complete and mail your absentee ballot also. Election officials will ensure that only one ballot is counted.
The Federal Voting Assistance Program offers additional information on military and overseas voting in Colorado. You can also call 1-800-438-VOTE (8683) or email vote@fvap.gov
\"\n },\n \"checkRegistration\": {\n \"question\": \"How can I check my voter registration status?\",\n \"answer\": \"You can look up your voter registration record and verify that your information is correct using Colorado's voter registration lookup tool.\"\n },\n \"contactElectionOffice\": {\n \"question\": \"Which election office should I contact?\",\n \"answer\": \"
  • In Colorado, your local election office runs the elections in your area. They can help you with questions about registering to vote, voting by mail, and local elections.
  • The Secretary of State oversees elections and election administration in Colorado. They can help you with questions about voting in your state, election security, or issues you might have at the polls. If you have concerns about voter intimidation, reach out immediately.
\"\n },\n \"localContactInfo\": {\n \"question\": \"How do I contact my local election office?\",\n \"answer\": \" Visit your states site to find your local election office.\"\n },\n \"stateContactInfo\": {\n \"question\": \"How do I contact my state election office?\",\n \"answer\": \"
Secretary of State
\"\n },\n \"voteInPerson\": {\n \"question\": \"How do I vote in person?\",\n \"answer\": \"

Where can I vote on Election Day?

You can look up where to vote on Colorado's site.

Can I vote early?

  • Yes, Colorado does offer early voting. You can choose whether to vote on Election Day or during the early voting period, whichever is easier for you. This can be especially helpful if it would be difficult or not possible for you to vote on Election Day. Early voting locations may be less crowded, as well.

What do I need to bring?

If you choose to vote in person in Colorado, you will need to show ID. If your form of identification shows your address, that address must be in the state of Colorado.

Acceptable forms include:
  • Colorado driver's license
  • valid ID card issued by the Colorado Department of Revenue
  • US passport
  • employee ID with photo issued by any entity of the US government or Colorado
  • pilot's license issued by the FAA or other authorized agency of the US
  • US military ID with photo
  • ID card issued by a federally recognized tribal government
  • Medicare or Medicaid card
  • certified copy of your US birth certificate
  • certificate of Degree of Indian or Alaskan Native Blood
  • certified documentation of naturalization
  • student ID with photo issued by a Colorado institute of higher education
  • veteran's ID with photo issued by the VA
  • current utility bill, bank statement, government check, paycheck, or other government document showing name and address (within last 60 days)

Voters without ID: If you are unable to provide ID, you will be able to vote a provisional ballot, or you may request a mail ballot to take home, sign, and return to your county clerk. Your signature is used to verify your identity on a mail ballot.

How can I check the status of my ballot?

You can check the status of your ballot on Colorados site.
\"\n },\n \"voteByMail\": {\n \"question\": \"How do I vote by mail?\",\n \"answer\": \"
Colorado conducts elections primarily by mail. If you are an active registered voter and you submitted your voter registration application at least eight days before Election Day, then you can expect to receive a ballot in the mail. It will be sent to the mailing address on your voter registration file.

If you are voting by mail for the first time, you may also need to provide a copy of your ID when you return your mail ballot. For more information, please visit the Colorado Secretary of State's website.

What should I do if I dont get my ballot?

If you dont receive your ballot in the mail, then contact your local election office. You can also vote in person at a voter service and polling center.

How do I return my ballot?

What do I need to do if Ive moved?

Whats on your ballot depends on where you live, so your voter registration is tied to your exact address. If youve moved, you need to re-register with your new address.

How can I check the status of my ballot?

You can check the status of your ballot on Colorados site.
\"\n },\n \"whatsOnTheBallot\": {\n \"question\": \"How do I see what's on my ballot?\",\n \"answer\": \" View your sample ballot on the Colorado Secretary of State's website. Available ballot information may vary depending on the upcoming election. \"\n }\n }\n }\n ]\n },\n \"pagination\": {\n \"totalRecordCount\": 2,\n \"currentPage\": 1,\n \"pageSize\": 10\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "20853cfd-dcb3-4b22-8bdf-880e862bb488", "name": "Bad Request", "originalRequest": { "url": { "path": [ "authorities", "state", ":stateCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "stateCode" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 400,\n \"message\": [\n \"Something has gone wrong parsing your query string. Please refer to our documentation at https://developers.democracy.works/api/v2 to confirm all required fields are present and all fields are formatted correctly.\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4b240121-1109-4bbf-bb73-f18eec8ead54", "name": "TooManyRequestsError", "originalRequest": { "url": { "path": [ "authorities", "state", ":stateCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "stateCode" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Too Many Requests\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "2e41744e-f508-4462-bc74-31d703d04171", "name": "InternalServerError", "originalRequest": { "url": { "path": [ "authorities", "state", ":stateCode" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [ { "disabled": false, "type": "any", "value": "", "key": "stateCode" } ] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 500,\n \"message\": [\n \"Something went wrong.\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "aede0428-b78f-42eb-9be1-6b338f82785b", "name": "All authorities", "request": { "name": "All authorities", "description": { "content": "This endpoint includes all statewide and local authorities that correspond to a given address or state parameter. \n\nThe 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. \n\nAuthorities 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.\n\nAuthorities are returned sorted alphabetically by OCD-ID. \n\nSupports the following standard parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__, __[Localization](#section/Standard-Parameters/Localization)__, and __[Content Formatting](#section/Standard-Parameters/Content-Formatting)__.\n", "type": "text/plain" }, "url": { "path": [ "authorities" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "address", "value": "" }, { "disabled": false, "key": "stateCode", "value": "" }, { "disabled": false, "key": "includeQuestionAndAnswer", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "06519095-2bf6-458d-ac45-4d3d7f20f429", "name": "Authorities fetched by query. Local (non-state) authorities will only have required fields.", "originalRequest": { "url": { "path": [ "authorities" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" }, { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"authorities\": [\n {\n \"ocdId\": \"ocd-division/country:us/state:al\",\n \"officeName\": \"Alabama\",\n \"officialTitle\": \"Office of the Secretary of State\",\n \"homepageUrl\": \"https://sos.alabama.gov/alabama-votes\",\n \"pollingLocationUrl\": \"https://myinfo.alabamavotes.gov/voterview\",\n \"votingWithDisabilitiesUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/assistance-disability\",\n \"votingWithPastConvictionsUrl\": \"https://www.sos.alabama.gov/sites/default/files/Voting-Rights-Final-Version.pdf\",\n \"canonicalUrl\": \"https://staging.voting.democracy.works/en/vote/al.html\",\n \"partyInstructions\": \"If you choose not to declare a political preference at the primary election, you will not be eligible to vote in any political partys primary election. You are, however, still eligible to vote on any proposed constitutional amendments that are up for a vote.\",\n \"updatedAt\": \"2023-12-05T10:05:43.853825+00:00\",\n \"timezone\": \"Central\",\n \"secondaryTimezone\": \"Eastern\",\n \"localElectionAuthorityOfficeAlias\": \"Absentee Election Manager\",\n \"separateRegistrationAndElectionAuthorities\": true,\n \"localElectionAuthorityName\": \"Local Authority\",\n \"localRegistrationAuthorityName\": \"Board of Registrars\",\n \"localRegistrationAuthorityLookupUrl\": \"https://www.sos.alabama.gov/city-county-lookup/bor\",\n \"localElectionAuthorityLookupUrl\": \"https://www.sos.alabama.gov/city-county-lookup/absentee-election-manager\",\n \"registrationAuthorityLevel\": \"county\",\n \"electionAuthorityLevel\": \"county\",\n \"contact\": {\n \"phone\": \"(334) 242-7210\",\n \"email\": \"alavoter@vote.alabama.gov\",\n \"physicalAddress\": {\n \"street\": \"600 Dexter Ave, Suite E-206\",\n \"city\": \"Montgomery\",\n \"state\": \"AL\",\n \"zip\": \"36130\"\n },\n \"mailingAddress\": {\n \"street\": \"P. O. Box 5616\",\n \"city\": \"Montgomery\",\n \"state\": \"AL\",\n \"zip\": \"36103-5616\"\n }\n },\n \"voting\": {\n \"inPersonVotingAvailable\": true,\n \"mailBallotsSentAutomatically\": false,\n \"inPerson\": {\n \"idRequiredAllVoters\": true,\n \"idInstructions\": \"You will need to show photo ID to vote in Alabama.
Acceptable\\nforms of valid photo ID include: Alabama driver's license (may be expired up\\nto 60 days); Alabama non-driver's ID card (may be expired up to 60 days); Alabama\\nphoto voter ID card; digital driver's license or non-driver ID issued by the\\nAlabama Law Enforcement Agency; photo ID card issued by Alabama or any other\\nstate (examples include AL Department of Corrections Release - Temporary ID,\\nAL Movement/Booking Sheet from Prison/Jail System, or a pistol permit); federal\\ngovernment issued ID; US passport; employee ID card issued by the federal government,\\nthe State of Alabama, county, municipality, board or other entity in Alabama;\\nstudent or employee ID issued by a public or private college or university in\\nAlabama; US military ID; valid tribal ID

Voters without ID: If you are\\nunable to provide ID, you will be able to vote a provisional ballot. In order\\nfor your ballot to be counted, you must provide your ID, including your address\\nand your telephone number, to the board of registrars no later than 5:00 P.M.\\non the Friday following the election. If you fail to provide ID to the board\\nof registrars by that time, your ballot will not be counted. In addition, voters\\nwho do not show valid photo ID at the polls can vote a regular ballot if they\\nare positively identified by two election officials as a voter on the poll list\\nwho is eligible to vote and the election officials sign a sworn affidavit.\\n\"\n },\n \"early\": {\n \"supported\": false,\n \"excuseRequired\": false,\n \"alias\": \"early vote\"\n },\n \"byMail\": {\n \"ballotApplicationOnline\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"returnByMailUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"eligibilityUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"returnInPersonUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter/absentee-voting\",\n \"excuseRequired\": true,\n \"excuses\": [\n {\n \"excuse\": \"absence\",\n \"example\": \"I expect to be out of the county or the state on election day.\"\n },\n {\n \"excuse\": \"illnessDisability\",\n \"example\": \"I am physically incapacitated and will not be able to vote in person on election day.\"\n },\n {\n \"excuse\": \"illnessAgeDisability\",\n \"example\": \"I have a physical illness or infirmity which prevents my attendance at the polls. I am unable to access my assigned polling place due to a neurological, musculoskeletal, respiratory (including speech organs), cardiovascular, or other life-altering disorder that affects my ability to perform manual tasks, stand for any length of time, walk unassisted, see, hear or speak and: \\ra) I am an elderly voter aged 65 or older; or \\rb) I am a voter with a disability.\"\n },\n {\n \"excuse\": \"employment\",\n \"example\": \"I expect to work a shift which has at least ten (10) hours that coincide with the polling hours at my regular polling place.\"\n },\n {\n \"excuse\": \"student\",\n \"example\": \"I am enrolled as a student at an educational institution located outside the county of my personal residence and am therefore unable to vote at my usual polling place on election day.\"\n },\n {\n \"excuse\": \"uocava\",\n \"example\": \"I am a member of, or a spouse or dependent of a member of, the Armed Forces of the United States or am otherwise similarly qualified to vote absentee pursuant to the Uniformed and Overseas Citizens Absentee Voting Act, 52 U.S.C. � 20302.\"\n },\n {\n \"excuse\": \"electionWorker\",\n \"example\": \"I have been appointed as an election officer at a polling place which is not my regular polling place.\"\n },\n {\n \"excuse\": \"caregiver\",\n \"example\": \"I am a caregiver for a family member to the second degree of kinship by affinity or consanguinity and the family member is confined to his or her home.\"\n },\n {\n \"excuse\": \"incarcerated\",\n \"example\": \"I am currently incarcerated in prison or jail and have not been convicted of a felony involving moral turpitude.\"\n }\n ],\n \"ballotTrackingUrl\": \"https://myinfo.alabamavotes.gov/voterview\",\n \"ballotApplicationDownload\": \"https://www.sos.alabama.gov/alabama-votes/absentee-ballot-applications\",\n \"idInstructions\": \"ID is required for all voters.\",\n \"alias\": \"absentee\"\n }\n },\n \"registration\": {\n \"statusUrl\": \"https://myinfo.alabamavotes.gov/voterview\",\n \"formUrl\": \"https://www.sos.alabama.gov/sites/default/files/voter-pdfs/nvra-2.pdf\",\n \"noRegistrationRequiredInstructions\": \"You cannot vote without valid registration.\",\n \"methods\": [\n \"byMail\",\n \"online\"\n ],\n \"byMail\": {\n \"supported\": true,\n \"url\": \"https://www.sos.alabama.gov/alabama-votes/voter/register-to-vote\",\n \"forms\": \"nvrf\",\n \"raceFieldRequired\": false,\n \"raceFieldInstructions\": \"You are required to fill in this box; however, your application will not be rejected if you fail to do so.\",\n \"idInstructions\": \"If you have one, you must provide your Alabama driver's license number or Alabama non-driver's identification card number. If you do not have an Alabama driver's license or non-driver's identification card, you must provide the last four digits of your Social Security number. If you have not been issued any of these numbers you must write the word \\\"NONE\\\" and a unique identifier will be provided for you.\",\n \"signatureInstructions\": \"To register in Alabama you must:
be a citizen of the United States
be a resident of Alabama and your county at the time of registration
be 18 years old on or before Election Day
not be barred from voting by reason of a disqualifying felony conviction, or if you have been convicted, you must have had your civil rights restored. You can find the list of disqualifying felonies on the Secretary of States website here at: sos.alabama.gov/mtfelonies
not have been declared mentally incompetent in a court
swear or affirm to \\\"support and defend the Constitution of the U.S. and the State of Alabama and further disavow any belief or affiliation with any group which advocates the overthrow of the governments of the U.S. or the State of Alabama by unlawful means and that the information contained herein is true\\\"\",\n \"citizenInstructions\": \"You must be a citizen to vote in Alabama.\",\n \"newVoterInstructions\": \"If you are registering to vote for the first time in your jurisdiction and are mailing this registration application, federal law requires you to show proof of identification the first time you vote. Proof of identification includes: current and valid photo identification or current utility bill, bank statement, government check, paycheck or government document that shows your name and address.
More information here.\"\n },\n \"online\": {\n \"supported\": true,\n \"instructions\": \"You should know: you need an Alabama driver's license or non-driver\\nID to use Alabama's online voter registration system. If you don't have an\\nAlabama-issued ID, you can still register by mail to vote.\\n\",\n \"url\": \"https://www.alabamainteractive.org/sos/voter_registration/voterRegistrationWelcome.action\"\n },\n \"inPerson\": {\n \"supported\": false,\n \"electionDayInstructions\": \"You cannot register to vote in person on Election Day in Alabama.\",\n \"advanceUrl\": \"https://www.sos.alabama.gov/alabama-votes/voter-registration/general-info?_ga=2.13156215.1931915915.1655313501-640998901.1644592274\"\n }\n },\n \"youthRegistration\": {\n \"url\": \"https://www.sos.alabama.gov/alabama-votes/youth-voter-registration\",\n \"formUrl\": \"https://www.sos.alabama.gov/alabama-votes/youth-voter-registration\",\n \"supported\": \"byElection\",\n \"methods\": \"online,by-mail,in-person\",\n \"onlineInstructions\": \"To register using the Alabama online voter registration system,\\nyou are required to provide ONE of the following valid ID numbers: Alabama Driver's\\nLicense; Alabama Non-Driver's Identification card

If you dont have an\\nAlabama-issued ID, you can still submit a voter registration application by mail\\nor in person.\\n\",\n \"inPersonInstructions\": \"You can complete a voter registration application in person at your local County Board of Registrars in Alabama.

You can also obtain a voter registration application in person at any of the following public agencies in Alabama: driver's licensing office; county and select municipal public libraries; public four-year universities and select private four-year universities

You can find a list of locations that provide voter registration services and voter registration application on the Alabama Secretary of States website.\",\n \"byMailInstructions\": \"When submitting your application by mail in Alabama, you are required to provide your Alabama Drivers License number or Alabama Non-Driver ID number. If you do not have one, you are required to provide the last four digits of your Social Security number. If you have not been issued any of these numbers, check the box that indicates you do not have an ID number. You may send with your application a copy of your valid photo ID.\",\n \"eligibilityAge\": \"18\",\n \"statusAvailability\": \"Unknown\"\n },\n \"questionAndAnswer\": {\n \"whoCanVote\": {\n \"question\": \"Who can register to vote?\",\n \"answer\": \"
To register in Alabama you must:
  • be a citizen of the United States
  • be a resident of Alabama and your county at the time of registration
  • be 18 years old on or before Election Day
  • not be barred from voting by reason of a disqualifying felony conviction, or if you have been convicted, you must have had your civil rights restored. You can find the list of disqualifying felonies on the Secretary of States website here at: sos.alabama.gov/mtfelonies
  • not have been declared mentally incompetent in a court
  • swear or affirm to \\\"support and defend the Constitution of the U.S. and the State of Alabama and further disavow any belief or affiliation with any group which advocates the overthrow of the governments of the U.S. or the State of Alabama by unlawful means and that the information contained herein is true\\\"
\"\n },\n \"byMailRegistration\": {\n \"question\": \"Can I submit voter registration forms by mail?\",\n \"answer\": \"

Use the National Voter Registration Form

  1. Print and fill out the National Voter Registration Form.
  2. Box 6 - ID Number: If you have one, you must provide your Alabama driver's license number or Alabama non-driver's identification card number. If you do not have an Alabama driver's license or non-driver's identification card, you must provide the last four digits of your Social Security number. If you have not been issued any of these numbers you must write the word \\\"NONE\\\" and a unique identifier will be provided for you.
  3. Box 7 - Choice of Party: If you choose not to declare a political preference at the primary election, you will not be eligible to vote in any political partys primary election. You are, however, still eligible to vote on any proposed constitutional amendments that are up for a vote.
  4. Box 8 - Race or Ethnic Group: You are required to fill in this box; however, your application will not be rejected if you fail to do so.
  5. Review the \\\"Who can register to vote?\\\" section above and check that you're eligible.
  6. Sign the form.
  7. Send the completed form to your Board of Registrars
  8. If you are registering to vote for the first time in your jurisdiction and are mailing this registration application, federal law requires you to show proof of identification the first time you vote. Proof of identification includes: current and valid photo identification or current utility bill, bank statement, government check, paycheck or government document that shows your name and address.
    • More information here.
\"\n },\n \"electionDayRegistration\": {\n \"question\": \"Can I register to vote on Election Day?\",\n \"answer\": \"Alabama does not offer registration on Election Day.\"\n },\n \"inPersonRegistration\": {\n \"question\": \"Can I submit voter registration forms in person?\",\n \"answer\": \"\"\n },\n \"youthRegistrationEligibility\": {\n \"question\": \"Can I register to vote before I turn 18?\",\n \"answer\": \" You can register to vote in Alabama before you turn 18 if you:
  • are at least 18 years old on or before Election Day
  • are a citizen of the United States
  • live in Alabama
  • have not been convicted of a disqualifying felony (or have had rights restored)
  • have not been legally declared \\\"mentally incompetent\\\" by a court

You must be at least 18 years old to vote.
\"\n },\n \"youthInPersonRegistration\": {\n \"question\": \"Can I complete a voter registration application in person before I turn 18?\",\n \"answer\": \"Yes, you can learn more about registering to vote in person on the Alabama Office of the Secretary of State website. You can complete a voter registration application in person at your local County Board of Registrars in Alabama.
You can also obtain a voter registration application in person at any of the following public agencies in Alabama:
  • driver's licensing office
  • county and select municipal public libraries
  • public four-year universities and select private four-year universities

You can find a list of locations that provide voter registration services and voter registration application on the Alabama Secretary of States website.\"\n },\n \"youthOnlineVoterRegistration\": {\n \"question\": \"Can I submit a voter registration application online before I turn 18?\",\n \"answer\": \" Yes, you can register online on the Alabama Office of the Secretary of State website. To register using the Alabama online voter registration system, you are required to provide ONE of the following valid ID numbers:
  • Alabama Driver's License
  • Alabama Non-Driver's Identification card

If you dont have an Alabama-issued ID, you can still submit a voter registration application by mail or in person. \"\n },\n \"youthByMailRegistration\": {\n \"question\": \"Can I submit a voter registration application by mail before I turn 18?\",\n \"answer\": \" Yes, you can register to vote by mail using this form. When submitting your application by mail in Alabama, you are required to provide your Alabama Drivers License number or Alabama Non-Driver ID number. If you do not have one, you are required to provide the last four digits of your Social Security number. If you have not been issued any of these numbers, check the box that indicates you do not have an ID number. You may send with your application a copy of your valid photo ID. \"\n },\n \"militaryAndOverseas\": {\n \"question\": \"How do I vote if I'm in the military or live overseas?\",\n \"answer\": \"
Active-duty military, their families, and overseas citizens can register to vote and request their absentee ballot using the Federal Post Card Application (FPCA). The FPCA process is done by mail, but your state may offer other options to request and return ballots. Please contact your Absentee Election Manager for more information about delivery and return methods, including email, fax, and state online portals. To follow the FPCA process:
  1. Fill out the Federal Post Card Application (FPCA), or download a copy. Your Absentee Election Manager may have questions, so please provide an email address or phone number where they can reach you.
  2. Send the application to your Absentee Election Manager.
  3. It is never too early to submit an FPCA! Please do so as soon as possible.
  4. Please fill out and send back your ballot as soon as you receive it.
  5. States begin mailing absentee ballots at least 45 days before Election Day. If you haven't received your ballot by 30 days before Election Day, contact your Absentee Election Manager.
If after submitting your FPCA, your ballot does not arrive, contact your Absentee Election Manager first. Then:
  • You can still vote using the Federal Write-In Absentee Ballot (FWAB). Print, sign, and mail your FWAB to your Absentee Election Manager.
  • If you mail a FWAB and then receive your regular absentee ballot, you should complete and mail your absentee ballot also. Election officials will ensure that only one ballot is counted.
The Federal Voting Assistance Program offers additional information on military and overseas voting in Alabama. You can also call 1-800-438-VOTE (8683) or email vote@fvap.gov
\"\n },\n \"checkRegistration\": {\n \"question\": \"How can I check my voter registration status?\",\n \"answer\": \"You can look up your voter registration record and verify that your information is correct using Alabama's voter registration lookup tool.\"\n },\n \"contactElectionOffice\": {\n \"question\": \"Which election office should I contact?\",\n \"answer\": \"
  • In Alabama, the Board of Registrars and Absentee Election Manager run voter registration and elections in your area. The Board of Registrars can help you with questions about registering to vote, and the Absentee Election Manager can help you with questions about voting, including voting by mail.
  • The Office of the Secretary of State oversees elections and election administration in Alabama. They can help you with questions about voting in your state, election security, or issues you might have at the polls. If you have concerns about voter intimidation, reach out immediately.
\"\n },\n \"localContactInfo\": {\n \"question\": \"How do I contact my local election office?\",\n \"answer\": \"Visit your states site to find the contact information for the Board of Registrars or the Absentee Election Manager. \"\n },\n \"stateContactInfo\": {\n \"question\": \"How do I contact my state election office?\",\n \"answer\": \"\"\n },\n \"voteInPerson\": {\n \"question\": \"How do I vote in person?\",\n \"answer\": \"

Where can I vote on Election Day?

You can look up where to vote on Alabama's site.

Can I vote early?

No, early voting in person before Election Day is not offered in this election. Alabama does offer absentee voting with an excuse in-person or by mail beginning 55 days prior to Election Day. Find the eligibility requirements for absentee voting and contact your Absentee Election Manager to check if you can visit their office to request and return an absentee ballot in person.

What do I need to bring?

You will need to show photo ID to vote in Alabama.

Acceptable forms of valid photo ID include:
  • Alabama driver's license (may be expired up to 60 days)
  • Alabama non-driver's ID card (may be expired up to 60 days)
  • Alabama photo voter ID card
  • digital driver's license or non-driver ID issued by the Alabama Law Enforcement Agency
  • photo ID card issued by Alabama or any other state (examples include AL Department of Corrections Release - Temporary ID, AL Movement/Booking Sheet from Prison/Jail System, or a pistol permit)
  • federal government issued ID
  • US passport
  • employee ID card issued by the federal government, the State of Alabama, county, municipality, board or other entity in Alabama
  • student or employee ID issued by a public or private college or university in Alabama
  • US military ID
  • valid tribal ID

Voters without ID: If you are unable to provide ID, you will be able to vote a provisional ballot. In order for your ballot to be counted, you must provide your ID, including your address and your telephone number, to the board of registrars no later than 5:00 P.M. on the Friday following the election. If you fail to provide ID to the board of registrars by that time, your ballot will not be counted. In addition, voters who do not show valid photo ID at the polls can vote a regular ballot if they are positively identified by two election officials as a voter on the poll list who is eligible to vote and the election officials sign a sworn affidavit.

How can I check the status of my ballot?

You can check the status of your ballot on Alabamas site.
\"\n },\n \"voteByMail\": {\n \"question\": \"How do I vote by mail?\",\n \"answer\": \"
Alabama allows eligible voters to request a mail ballot. All other voters are expected to vote in person. Check to see if youre eligible to vote by mail on Alabama's site.

How do I get my ballot?

Request your mail-in ballot with a mail ballot application.

What should I do if I dont get my ballot?

If you dont receive your ballot in the mail, then contact your Absentee Election Manager.

How do I return my ballot?

What do I need to do if Ive moved?

Whats on your ballot depends on where you live, so your voter registration is tied to your exact address. If youve moved, you need to re-register with your new address.

How can I check the status of my ballot?

You can check the status of your ballot on Alabamas site.
\"\n },\n \"whatsOnTheBallot\": {\n \"question\": \"How do I see what's on my ballot?\",\n \"answer\": \"Learn more about what will be on your ballot by visiting the Alabama website.\"\n }\n }\n },\n {\n \"ocdId\": \"ocd-division/country:us/state:ri/place:coventry\",\n \"officeName\": \"Coventry Town\",\n \"officialTitle\": \"Board of Canvassers\",\n \"homepageUrl\": \"https://www.coventryri.org/board-canvassers\",\n \"registrationAuthorityLevel\": \"municipal\",\n \"electionAuthorityLevel\": \"municipal\",\n \"isRegistrationContact\": false,\n \"contact\": {\n \"email\": \"landerson@coventryri.org\",\n \"physicalAddress\": {\n \"street\": \"1675 FLAT RIVER RD\",\n \"city\": \"COVENTRY\",\n \"state\": \"RI\",\n \"zip\": 2816\n },\n \"mailingAddress\": {\n \"street\": \"1670 FLAT RIVER RD\",\n \"city\": \"COVENTRY\",\n \"state\": \"RI\",\n \"zip\": 2816\n }\n }\n }\n ]\n },\n \"pagination\": {\n \"totalRecordCount\": 2,\n \"currentPage\": 1,\n \"pageSize\": 10\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "ac78be91-155f-46ca-8041-c3d540f585df", "name": "Bad Request", "originalRequest": { "url": { "path": [ "authorities" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" }, { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 400,\n \"message\": [\n \"Something has gone wrong parsing your query string. Please refer to our documentation at https://developers.democracy.works/api/v2 to confirm all required fields are present and all fields are formatted correctly.\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "6b2fa9ae-1a4d-43ad-9bb0-fe1977717dd7", "name": "TooManyRequestsError", "originalRequest": { "url": { "path": [ "authorities" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" }, { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Too Many Requests\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "471ecb90-f315-4b80-b2a1-47edeb4a5331", "name": "InternalServerError", "originalRequest": { "url": { "path": [ "authorities" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" }, { "key": "includeQuestionAndAnswer", "value": "true" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 500,\n \"message\": [\n \"Something went wrong.\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } }, { "id": "1dabfa84-358c-437e-bec0-e4d2f1df75ab", "name": "Local authorities", "request": { "name": "Local authorities", "description": { "content": "This endpoint provides contact information for over 8,500 local election offices at the county and municipal levels.\n\nAuthorities are returned sorted alphabetically by OCD-ID. \n\nSupports the following standard parameters: see __[Pagination](#section/Standard-Parameters/Pagination)__ and __[Localization](#section/Standard-Parameters/Localization)__.\n", "type": "text/plain" }, "url": { "path": [ "authorities", "local" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "address", "value": "" }, { "disabled": false, "key": "stateCode", "value": "" } ], "variable": [] }, "header": [ { "key": "Accept", "value": "application/json" } ], "method": "GET", "auth": { "type": "apikey", "apikey": [ { "key": "key", "value": "x-api-key" }, { "key": "value", "value": "{{apiKey}}" }, { "key": "in", "value": "header" } ] } }, "response": [ { "id": "1257733d-0f6e-4d58-a760-0c87aa84f0c4", "name": "Local authorities fetched. As all authorities will be local (non-state), they will only have required fields.", "originalRequest": { "url": { "path": [ "authorities", "local" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "OK", "code": 200, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"data\": {\n \"authorities\": [\n {\n \"ocdId\": \"ocd-division/country:us/state:ak/borough:juneau\",\n \"officeName\": \"Juneau City And Borough\",\n \"officialTitle\": \"Region I Elections Office\",\n \"homepageUrl\": \"https://juneau.org/clerk/elections\",\n \"registrationAuthorityLevel\": \"county\",\n \"electionAuthorityLevel\": null,\n \"isRegistrationContact\": false,\n \"contact\": {\n \"email\": \"electionsr1@alaska.gov\",\n \"physicalAddress\": {\n \"street\": \"9109 MENDENHALL MALL RD STE 3\",\n \"city\": \"JUNEAU\",\n \"state\": \"AK\",\n \"zip\": \"99801-7136\"\n },\n \"mailingAddress\": {\n \"street\": \"PO BOX 110018\",\n \"city\": \"JUNEAU\",\n \"state\": \"AK\",\n \"zip\": \"99811-0018\"\n }\n }\n },\n {\n \"ocdId\": \"ocd-division/country:us/state:ri/place:coventry\",\n \"officeName\": \"Coventry Town\",\n \"officialTitle\": \"Board of Canvassers\",\n \"homepageUrl\": \"https://www.coventryri.org/board-canvassers\",\n \"registrationAuthorityLevel\": \"municipal\",\n \"electionAuthorityLevel\": \"municipal\",\n \"isRegistrationContact\": false,\n \"contact\": {\n \"email\": \"landerson@coventryri.org\",\n \"physicalAddress\": {\n \"street\": \"1675 FLAT RIVER RD\",\n \"city\": \"COVENTRY\",\n \"state\": \"RI\",\n \"zip\": 2816\n },\n \"mailingAddress\": {\n \"street\": \"1670 FLAT RIVER RD\",\n \"city\": \"COVENTRY\",\n \"state\": \"RI\",\n \"zip\": 2816\n }\n }\n }\n ]\n },\n \"pagination\": {\n \"totalRecordCount\": 2,\n \"currentPage\": 1,\n \"pageSize\": 10\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "f67f9304-5822-4aaa-81ba-3b871872ee8e", "name": "Bad Request", "originalRequest": { "url": { "path": [ "authorities", "local" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Bad Request", "code": 400, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 400,\n \"message\": [\n \"Something has gone wrong parsing your query string. Please refer to our documentation at https://developers.democracy.works/api/v2 to confirm all required fields are present and all fields are formatted correctly.\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "3b2e9fd6-8af1-47fb-b8bc-024546dc90b7", "name": "TooManyRequestsError", "originalRequest": { "url": { "path": [ "authorities", "local" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Too Many Requests", "code": 429, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"message\": \"Too Many Requests\"\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "4be53c1d-a4aa-4b0d-91c7-6d47f948917b", "name": "InternalServerError", "originalRequest": { "url": { "path": [ "authorities", "local" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "1101 Biscayne Blvd, Miami, FL 33132" }, { "key": "stateCode", "value": "CA" } ], "variable": [] }, "header": [ { "description": { "content": "Added as a part of security scheme: apikey", "type": "text/plain" }, "key": "x-api-key", "value": "" }, { "key": "Accept", "value": "application/json" } ], "method": "GET", "body": {} }, "status": "Internal Server Error", "code": 500, "header": [ { "key": "Content-Type", "value": "application/json" } ], "body": "{\n \"status\": 500,\n \"message\": [\n \"Something went wrong.\"\n ]\n}", "cookie": [], "_postman_previewlanguage": "json" } ], "event": [], "protocolProfileBehavior": { "disableBodyPruning": true } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.democracy.works/v2", "key": "baseUrl" } ], "info": { "_postman_id": "13bc5785-9f7d-4dc8-85d5-718562f83fe1", "name": "Democracy Works Authorities API", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "description": { "content": "# Introduction\n\nThe Democracy Works Elections API provides your application with comprehensive elections data and voting guidance, surfacing our unparalleled coverage of upcoming local, state, and federal elections. Power your platforms, apps, reminders, outreach campaigns, and much more.\n\nJoin the community of developers in our [Google Group](https://groups.google.com/a/democracy.works/g/democracy-works-data)\nfor updates about our data and elections.\n\n## Authentication\nAccess to the Democracy Works Elections API requires authentication. To access the DW API, include an X-API-Key header with each API request. The value of that header should be your API key. For example:\n\n```sh\ncurl \"https://api.democracy.works/v2/elections\" \\\n --header \"X-API-KEY: \"\n```\n\nFor pricing information and to obtain a test key, please [contact us](https://data.democracy.works/api-signup).\n\n## Base URL\nThe base URL for all API endpoints is: https://api.democracy.works/v2\n\n## Support\nIf you have any further questions or issues, please contact us at partnerships@democracy.works.\n\n## Data\n\nData is captured in two entities, an __Election__ and an __Authority__. The __Election__ 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 __Authority__ includes statewide evergreen information and instructions on how to register and vote for each state, as well as election office contact information. \n\n# Open Civic Data IDs (OCD-IDs)\n\nWe use Open Civic Data IDs [(OCD-IDs)](https://opencivicdata.info/en/latest/ocdids.html) \nthroughout the API to describe entities and filter results. \n\nOCD-IDs start with what is being identified, and in our case it is always \n`ocd-division`.\n\nSince all authorities are, or are contained within, a state and all elections \nare run by some authority, almost every OCD-ID in our system starts with \n`ocd-division/country:us/state:__`, where `__` is a two-letter state postal code.\n\nThe only exception to this is for the District of Columbia, which has the OCD-ID \n`ocd-division/country:us/district:dc`.\n\n## OCD-ID on the Authority\nThe OCD-ID associated with an authority describes the political district covered\nby an authority. Authorities are uniquely identifiable by the associated OCD-ID.\n\nFor example:\n- The OCD-ID `ocd-division/country:us/state:ak/place:anderson` is associated \n with the authority for Anderson, Alaska.\n- The OCD-ID `ocd-division/country:us/state:ny/county:albany/council_district:2` \n is not associated with an authority because Albany's 2nd Ward is a legislative \n ward which does not run its own elections.\n\n## OCD-ID on the Election\nThe OCD-ID associated with an election describes the highest-level district \nin which all voters have something to vote for on the ballot on Election Day. \nElections always have an associated OCD-ID, but are not uniquely\nidentifiable by the associated OCD-ID.\n\nFor example:\n- If there is a mayoral race in Philadelphia as well as a state-wide \nmeasure contest in Pennsylvania on a given day, there will be one election \nentity with OCD-ID `ocd-division/country:us/state:pa`.\n- If there is only a mayoral race in Pittsburgh in Allegheny County on a given \nday, there will be an election entity with OCD-ID \n`ocd-division/country:us/state:pa/county:allegheny`.\n\n# Standard Parameters\nFunctionality shared between API endpoints is noted here. Each endpoint will\nspecify whether it supports the following functionality.\n\n## Pagination\nAny endpoint that returns multiple results supports pagination. An endpoint that \nsupports pagination accepts two related query parameters:\n- `pageSize`\n - Specifies the number of results requested. Defaults to 10 if not specified. The maximum value is 100.\n - Example: `pageSize=15`\n- `page`\n - Specifies the page to return, based on `pageSize`. Defaults to 1 if not specified.\n - Example: `page=2`\n\nYou can send none, one, or both of these parameters. Each endpoint that supports\npagination will have a `pagination` field in the response, which details what\npage of information is returned, what page size was used for the request, and the\ntotal number of results found. \n\n## Localization\nSome endpoints support localization. An endpoint that supports localization accepts a\nheader parameter:\n- `Accept-Language`\n - Specifies the language tag for localization. Accepted values are `en`, `en-US`, `es`, and `es-US`.\n - Example: `Accept-Language: es`\n\nNot all fields on the response of a localized endpoint are localized. Each field that supports localization\nwill have a `Localized` tag on its field description.\n\nIf no localization in the requested language is found,\nlocalized fields will return `null`.\n\n## Content Formatting\nSome endpoints support content formatting. An endpoint that supports formatting accepts a\nquery parameter:\n- `contentFormatType`\n - Specifies the format of certain fields in the response.\n Accepted values are `html` and `json`. Defaults to `html` if not specified.\n - Example: `contentFormatType=json`\n\nNot all fields on the response of a formatted endpoint are formatted. \nFormatting is generally supported on prose-like fields, including Question and Answer content and most instruction fields.\nEach field that supports formatting will have a `Formatted` tag on its field description.\n\nThe `json`-formatted content is the content represented as an [AST](https://en.wikipedia.org/wiki/Abstract_syntax_tree).\n\n## Fields\nSome endpoints support field masking to specify a list of fields to include in the API response. This helps to avoid unnecessary computation and improve performance. An endpoint that supports field masking accepts a\nquery parameter:\n- `fields`\n - Specifies the symbolic field paths to include in the response, provided as comma-separated list. See more about [Field Masks](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask).\n - Example: `fields=\"ocdId,date,contact.email\"`\n\nPaths are validated against all possible fields, and providing an invalid path will result in a 400 response.\n", "type": "text/plain" } } }