{ "item": [ { "id": "c9006bdb-f1d9-4d7b-bb64-1b67afb1bee1", "name": "Elections", "description": { "content": "", "type": "text/plain" }, "item": [ { "id": "eb0738bd-f21f-474b-82c3-78b902e6087b", "name": "Elections", "request": { "name": "Elections", "description": { "content": "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. \n\nAfter an election is confirmed to be occurring, Democracy Works surfaces information about an election as details become available. An elections guidance phase describes the state of the currently available guidance.\n\nA `past` election is an election whose election date is in the past. A `known` election is an upcoming election for which key details and deadlines have yet to be released. An `active` election is an upcoming election for which details have been vetted and confirmed by the Democracy Works team.\n\nElections are returned sorted chronologically by election date. \n\nSupports 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)__.\n\n### Ballot Measure Information\n\nInformation about measures on the ballot are available for the following elections:\n- All federal elections\n- All statewide elections\n\nBallot 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`.\n\nBallot data is sourced from [Ballotpedia](https://ballotpedia.org/).\n\n### Candidate and Contest Information\n\nFor the November 5, 2024 elections, our ballot information will include the following:\n- All federal contests and candidates, including president, vice president, senate, and house of representatives\n- All state contests and candidates, including governor, treasurer, secretary of state, state legislative seats, state supreme court, district court, and court of appeals\n- Local candidates and contests including mayor, county judge, county clerk, commissioners, and city councils in the top 100 cities by population, plus state capitals and school board elections in 475 districts\n - Local coverage may be limited by mapping constraints and in states where primaries have not yet been held.\n\nBallot data is sourced from [Ballotpedia](https://ballotpedia.org/).\n", "type": "text/plain" }, "url": { "path": [ "elections" ], "host": [ "{{baseUrl}}" ], "query": [ { "disabled": false, "key": "address", "value": "" }, { "disabled": false, "key": "addressStreet", "value": "" }, { "disabled": false, "key": "addressCity", "value": "" }, { "disabled": false, "key": "addressStateCode", "value": "" }, { "disabled": false, "key": "addressZip", "value": "" }, { "disabled": false, "key": "addressZip4", "value": "" }, { "disabled": false, "key": "stateCode", "value": "" }, { "disabled": false, "key": "ocdId", "value": "" }, { "disabled": false, "key": "startDate", "value": "" }, { "disabled": false, "key": "endDate", "value": "" }, { "disabled": false, "key": "includeQuestionAndAnswer", "value": "" }, { "disabled": false, "key": "includeBallotData", "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": "230df91a-a218-47c7-9849-eef80bf56e5f", "name": "Elections fetched by query.", "originalRequest": { "url": { "path": [ "elections" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "813%20Howard%20Street%20Oswego%20NY%2013126" }, { "key": "addressStreet", "value": "813%20Howard%20Street" }, { "key": "addressCity", "value": "Oswego" }, { "key": "addressStateCode", "value": "NY" }, { "key": "addressZip", "value": "13126" }, { "key": "addressZip4", "value": "9029" }, { "key": "stateCode", "value": "CA" }, { "key": "ocdId", "value": "ocd-division%2Fcountry%3Aus%2Fstate%3Any%2Fcounty%3Akings" }, { "key": "startDate", "value": "2023-01-01" }, { "key": "endDate", "value": "2023-01-02" }, { "key": "includeQuestionAndAnswer", "value": "true" }, { "key": "includeBallotData", "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 \"elections\": [\n {\n \"ocdId\": \"ocd-division/country:us/state:wi\",\n \"createdAt\": \"2020-01-01T00:00:00.000-05:00\",\n \"updatedAt\": \"2020-02-01T00:00:00.000-05:00\",\n \"date\": \"2020-11-03\",\n \"description\": \"Wisconsin General Election\",\n \"type\": \"state\",\n \"pollingLocationUrl\": \"https://myvote.wi.gov/en-us/FindMyPollingPlace\",\n \"canonicalUrl\": \"https://voting.democracy.works/en/elections/wi/2020-11-03.html\",\n \"website\": \"https://myvote.wi.gov/en-us/\",\n \"guidancePhase\": \"past\",\n \"population\": \"5,880,101\",\n \"voting\": {\n \"inPersonVotingAvailable\": true,\n \"mailBallotsSentAutomatically\": false,\n \"early\": {\n \"url\": \"https://voting.democracy.works/en/elections/wi/2023-02-21.html\",\n \"startDate\": \"2023-02-07\",\n \"endDate\": \"2023-02-19\",\n \"varies\": true\n },\n \"byMail\": {\n \"idInstructions\": \"Active military, permanent overseas voters, and confidential\\nelectors are not required to provide a Photo ID when they vote by absentee ballot.\\nAn indefinitely confined voter does not need to provide a copy of Photo ID.\\nInstead, the witness signature on the Absentee Ballot Certificate Envelope\\nsatisfies the Photo ID requirement. For all other absentee voters, you will\\nneed to provide a copy of your acceptable photo ID with your request. If you\\nhave not previously provided a copy of photo ID, photo ID must accompany your\\nfirst application by mail.

These photo IDs are acceptable and can be\\nunexpired or expired after the date of the most recent general election: A Wisconsin\\nDOT-issued driver license, even if driving privileges are revoked or suspended;\\nA Wisconsin DOT-issued identification card; Military ID card issued by a U.S.\\nuniformed service; A U.S. passport. An identification card issued by a federally\\nrecognized Indian tribe in Wisconsin; A photo identification card issued by\\na Wisconsin accredited university or college that contains date of issuance,\\nexpiration date no later than two years after issuance, and signature of student\\n(must be accompanied by a separate document that proves enrollment if the student\\nID is expired).

These photo IDs are also acceptable for voting purposes,\\nbut must be unexpired: A veteran's photo identification card issued by the\\nVeterans Health Administration of the federal Department of Veterans Affairs;\\nA certificate of naturalization that was issued not earlier than two years before\\nthe date of an election at which it is presented; A driving receipt issued by\\nWisconsin DOT (valid for 45 days); An identification card receipt issued by\\nWisconsin DOT (valid for 45 days); a temporary identification card receipt\\nissued by Wisconsin DOT through the Identification Petition Process (IDPP) (valid\\nfor 60 days).\\n\",\n \"explainerUrl\": \"https://myvote.wi.gov/en-us/vote-by-mail\",\n \"allMail\": {\n \"ballotInfoUrl\": \"https://myvote.wi.gov/en-us/ballot-info\",\n \"ballotSendStartDate\": \"2020-10-10\",\n \"ballotSendEndDate\": \"2020-10-30\",\n \"ballotReceiveExpectedStartDate\": \"2020-10-25\",\n \"ballotReceiveExpectedEndDate\": \"2020-11-03\"\n },\n \"deadline\": {\n \"postmarkedOrReceived\": \"received\",\n \"receivedNoLaterThan\": {\n \"date\": \"2020-11-14\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of business\"\n },\n \"returnInPerson\": {\n \"date\": \"2020-11-03\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of polls\"\n },\n \"returnByMail\": {\n \"date\": \"2020-11-03\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of business\"\n },\n \"ballotRequest\": {\n \"postmarkedOrReceived\": \"postmarked\",\n \"date\": \"2023-02-16\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of business\"\n }\n }\n },\n \"inPerson\": {\n \"idRequiredAllVoters\": true,\n \"idInstructions\": \"You will need to show a photo ID to vote in Wisconsin.
An\\nacceptable photo ID is not required to contain a current address. These photo\\nIDs are acceptable and can be unexpired or expired after the date of the most\\nrecent general election: Wisconsin DOT-issued driver license, even if driving\\nprivileges are revoked or suspended, with or without a star in the right-hand\\ncorner; Wisconsin DOT-issued identification card, with or without a star in\\nthe right-hand corner; Wisconsin DOT-issued identification card or driver license\\nwithout a photo issued under the religious exemption; military ID card issued\\nby a U.S. uniformed service; U.S. passport

The following photo ID is\\nalso acceptable for voting purposes, and can be expired before the date of the\\nmost recent general election: identification card issued by a federally recognized\\nIndian tribe in Wisconsin; photo identification card issued by a Wisconsin accredited\\nuniversity or college that contains date of issuance, expiration date no later\\nthan two years after issuance, and signature of student (must be accompanied\\nby a separate document that proves enrollment if the student ID is expired)


The\\nfollowing photo IDs are also acceptable for voting purposes, but must be unexpired:\\nveteran's photo identification card issued by the Veterans Health Administration\\nof the federal Department of Veterans Affairs; certificate of naturalization\\nthat was issued not earlier than two years before the date of an election at\\nwhich it is presented; driving receipt issued by Wisconsin DOT (valid for 45\\ndays); identification card receipt issued by Wisconsin DOT (valid for 45 days);\\ntemporary identification card receipt issued by Wisconsin DOT through the Identification\\nPetition Process (IDPP) (valid for 60 days)

Voters without ID: If you\\nare unable to provide photo ID, you will be able to vote a provisional ballot.\\nYour provisional ballot will not count unless you provide an acceptable photo\\nID to the poll workers by 8:00 p.m. on Election Day or to your municipal clerk\\nin person by 4:00 p.m. the Friday after the election.\\n\",\n \"electionDay\": {\n \"closing\": {\n \"timestamp\": \"17:00\",\n \"description\": \"Close of polls\"\n }\n }\n }\n },\n \"registration\": {\n \"explainerUrl\": \"https://myvote.wi.gov/en-us/register-by-mail\",\n \"inPerson\": {\n \"atPollingPlaceOnElectionDay\": true,\n \"localSamedayRegistrationAuthorityLookupUrl\": \"https://myvote.wi.gov/en-us/register\",\n \"deadline\": {\n \"date\": \"2023-02-17\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of business\"\n }\n },\n \"online\": {\n \"url\": \"https://myvote.wi.gov/en-us/RegisterToVote\",\n \"instructions\": \"You should know: you need a Wisconsin driver's license or state\\nID card to use Wisconsin's online voter registration system. The address where\\nyou're registering needs to match the address the DMV has on file for you.\\nIf you don't have a Wisconsin ID, you can still register by mail to vote.\\n\",\n \"deadline\": {\n \"date\": \"2023-02-01\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of business\"\n }\n },\n \"byMail\": {\n \"idInstructions\": \"When submitting your application by mail in Wisconsin, you are required to provide your valid and unexpired Wisconsin driver license or Wisconsin state ID number and the expiration date. If you have not been issued a Wisconsin ID, or if you have an expired, canceled, suspended, or revoked Wisconsin-issued ID, 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 must also provide proof of residence when registering to vote. If you submit your application by mail, you must include a copy of proof of residence or submit proof of residence in an electronic format. Acceptable forms include but are not limited to: current and valid State of Wisconsin Driver License or State ID card or any official ID card or license issued by the Wisconsin government. When filling out a voter registration application, you must review the registration qualifications in Box 1. If you meet the requirements, check all of the boxes. If you do not meet all of the requirements, do not submit the form.\",\n \"signatureInstructions\": \"To register in Wisconsin you must:
be a citizen of the United States
be a resident of Wisconsin and have resided at the registration address for at least 28 days prior to the election
be 18 years old on or before Election Day
not have been convicted of treason, felony or bribery, or if you have, your civil rights have been restored after completion of your sentence or a pardon
not have been found by a court to be incapable of understanding the objective of the electoral process
not make or benefit from a bet or wage depending on the result of an election
not have voted at any other location, if registering on Election Day\",\n \"newVoterInstructions\": \"New voters should follow the instructions on the website to register.\",\n \"deadline\": {\n \"date\": \"2023-02-01\",\n \"timestamp\": \"17:00\",\n \"description\": \"Close of business\",\n \"postmarkedOrReceived\": \"postmarked\"\n }\n }\n },\n \"questionAndAnswer\": {\n \"keyChanges\": {\n \"question\": \"What key changes should voters know about?\",\n \"answer\": \"
Key changes to voting requirements in Wisconsin:
  • Eligible voters in Wisconsin may now vote early in-person without an excuse for state and federal elections.\"\n },\n \"keyChangesElection\": {\n \"question\": \"What key changes should voters know about?\",\n \"answer\": \"Voters must show ID to vote in Wisconsin.\"\n },\n \"voteInPerson\": {\n \"question\": \"How do I vote in person?\",\n \"answer\": \"
    You can look up where to vote the state website.
    \"\n },\n \"voteByMail\": {\n \"question\": \"How do I vote by mail?\",\n \"answer\": \"
    In Wisconsin, any registered voter can request to get a ballot by mail. Fill out the mail ballot application and mail or return it in person to your local election office.

    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.

    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 Wisconsins site.
    \"\n },\n \"whoCanVote\": {\n \"question\": \"Who can register to vote?\",\n \"answer\": \"
    To register in Wisconsin you must:
    • be a citizen of the United States
    • be a resident of Wisconsin and have resided at the registration address for at least 28 days prior to the election
    • be 18 years old on or before Election Day
    • not have been convicted of treason, felony or bribery, or if you have, your civil rights have been restored after completion of your sentence or a pardon
    • not have been found by a court to be incapable of understanding the objective of the electoral process
    • not make or benefit from a bet or wage depending on the result of an election
    • not have voted at any other location, if registering on Election Day
    \"\n },\n \"onlineVoterRegistration\": {\n \"question\": \"Can I register to vote online?\",\n \"answer\": \"
    • Wisconsin offers online voter registration.
    • You should know: you need a Wisconsin driver's license or state ID card to use Wisconsin's online voter registration system. The address where you're registering needs to match the address the DMV has on file for you. If you don't have a Wisconsin ID, you can still register by mail to vote.
    \"\n },\n \"byMailRegistration\": {\n \"question\": \"Can I submit voter registration forms by mail?\",\n \"answer\": \"
    Yes, you can print, complete and mail the National Voter Registration Form to register to vote in Wisconsin.

    Heres some advice on how to complete the form:
    • Box 6 - ID Number
      • Provide your unexpired Wisconsin driver license or DOT-issued ID card number.
        • If you do not have one of these ID numbers, provide the last four digits of your Social Security number (SSN).
        • If you do not have one of these ID numbers or SSN, you will still be able to register to vote.
        You must also provide Proof of Residence documentation when registering. All Proof of Residence documents must show your name and current residential address. Acceptable forms include but are not limited to:
        • current and valid State of Wisconsin Driver License or State ID card
        • any official ID card or license issued by the Wisconsin government
        Find additional forms of proof of residence from the Wisconsin Election Commission.
    • Box 7 - Choice of Party: Wisconsin does NOT require that you register with a party to participate in partisan primary elections.
    • Box 8 - Race or Ethnic Group: Not required.
    • Review the \\\"Who can register to vote?\\\" section and check that you're eligible.
    • Sign the form.
    • Send the completed form to your local election office

    What if I'm registering to vote for the first time in my jurisdiction and mailing this registration application?

      \"\n },\n \"electionDayRegistration\": {\n \"question\": \"Can I register to vote on Election Day?\",\n \"answer\": \"Wisconsin 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 \"datesAndDeadlines\": {\n \"question\": \"What are key deadlines for this election?\",\n \"answer\": \"\"\n },\n \"voterId\": {\n \"question\": \"Do I need to bring an ID to vote in person?\",\n \"answer\": \"
      You will need to show a photo ID to vote in Wisconsin.

      An\\nacceptable photo ID is not required to contain a current address. These photo\\nIDs are acceptable and can be unexpired or expired after the date of the most\\nrecent general election:
      • Wisconsin DOT-issued driver license, even\\nif driving privileges are revoked or suspended, with or without a star in the\\nright-hand corner
      • Wisconsin DOT-issued identification card, with or\\nwithout a star in the right-hand corner
      • Wisconsin DOT-issued identification\\ncard or driver license without a photo issued under the religious exemption
      • \\nmilitary ID card issued by a U.S. uniformed service
      • U.S. passport

      The\\nfollowing photo ID is also acceptable for voting purposes, and can be expired\\nbefore the date of the most recent general election:
      • identification\\ncard issued by a federally recognized Indian tribe in Wisconsin
      • photo\\nidentification card issued by a Wisconsin accredited university or college that\\ncontains date of issuance, expiration date no later than two years after issuance,\\nand signature of student (must be accompanied by a separate document that proves\\nenrollment if the student ID is expired)

      The following\\nphoto IDs are also acceptable for voting purposes, but must be unexpired:
        \\n\\\\
      • veteran's photo identification card issued by the Veterans Health Administration\\nof the federal Department of Veterans Affairs
      • certificate of naturalization\\nthat was issued not earlier than two years before the date of an election at\\nwhich it is presented
      • driving receipt issued by Wisconsin DOT (valid\\nfor 45 days)
      • identification card receipt issued by Wisconsin DOT (valid\\nfor 45 days)
      • temporary identification card receipt issued by Wisconsin\\nDOT through the Identification Petition Process (IDPP) (valid for 60 days)

      Voters\\nwithout ID: If you are unable to provide photo ID, you will be able to vote\\na provisional ballot. Your provisional ballot will not count unless you provide\\nan acceptable photo ID to the poll workers by 8:00 p.m. on Election Day or to\\nyour municipal clerk in person by 4:00 p.m. the Friday after the election.
      \\n\"\n },\n \"whatsOnTheBallot\": {\n \"question\": \"How do I see what's on my ballot?\",\n \"answer\": \" \"\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 Wisconsin. 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 Wisconsin's voter registration lookup tool.\"\n },\n \"stateContactInfo\": {\n \"question\": \"How do I contact my state election office?\",\n \"answer\": \"\"\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 }\n },\n {\n \"ocdId\": \"ocd-division/country:us/state:ca/county:marin/school_district:novato_unified\",\n \"createdAt\": \"2023-02-22T15:54:43.000-05:00\",\n \"updatedAt\": \"2023-03-05T23:31:00.000-05:00\",\n \"date\": \"2023-03-07\",\n \"description\": \"Novato Unified School District Special Tax Election\",\n \"type\": \"school\",\n \"pollingLocationUrl\": \"https://voterstatus.sos.ca.gov\",\n \"canonicalUrl\": \"https:/voting.democracy.works/en/elections/ca/county/marin/school_district/novato_unified/2023-03-07.html\",\n \"website\": \"https://www.marincounty.org/depts/rv/election-info/march-7-2023\",\n \"guidancePhase\": \"past\",\n \"population\": \"62,142\",\n \"voting\": {\n \"inPersonVotingAvailable\": true,\n \"mailBallotsSentAutomatically\": true,\n \"early\": {\n \"url\": \"https://www.marincounty.org/depts/rv/election-info/march-7-2023/page-data/tabs-collection/vote-centers-and-drop-boxes/votecenters\",\n \"startDate\": \"2023-02-06\",\n \"endDate\": \"2023-03-06\",\n \"varies\": null\n },\n \"byMail\": {\n \"idInstructions\": null,\n \"explainerUrl\": null,\n \"allMail\": {\n \"ballotInfoUrl\": null,\n \"ballotSendStartDate\": null,\n \"ballotSendEndDate\": null,\n \"ballotReceiveExpectedStartDate\": null,\n \"ballotReceiveExpectedEndDate\": null\n },\n \"deadline\": {\n \"postmarkedOrReceived\": null,\n \"receivedNoLaterThan\": {\n \"date\": null,\n \"timestamp\": null,\n \"description\": null\n },\n \"returnInPerson\": {\n \"date\": null,\n \"timestamp\": null,\n \"description\": null\n },\n \"returnByMail\": {\n \"date\": null,\n \"timestamp\": null,\n \"description\": null\n },\n \"ballotRequest\": {\n \"postmarkedOrReceived\": null,\n \"date\": null,\n \"timestamp\": null,\n \"description\": null\n }\n }\n },\n \"inPerson\": {\n \"idRequiredAllVoters\": false,\n \"idInstructions\": \"If you choose to vote in person and youve voted in California\\nbefore, you dont need to show ID.

      If youre a first time voter in a\\nfederal election who registered by mail and didnt include your drivers license\\nnumber, California ID number, or the last four digits of your Social Security\\nnumber on your registration, you may be asked to provide ID when you vote.
      Acceptable\\nforms include: copy of a recent utility bill; sample ballot booklet you received\\nfrom your county elections office or another document sent to you by a government\\nagency; US passport; driver's license; official state identification card;\\nstudent identification card showing your name and photograph

      Voters without\\nID: If you are unable to provide ID, you will be able to vote a provisional\\nballot.\\n\",\n \"electionDay\": {\n \"closing\": {\n \"timestamp\": null,\n \"description\": null\n }\n }\n }\n },\n \"registration\": {\n \"explainerUrl\": null,\n \"inPerson\": {\n \"atPollingPlaceOnElectionDay\": null,\n \"localSamedayRegistrationAuthorityLookupUrl\": null,\n \"deadline\": {\n \"date\": \"2023-03-07\",\n \"timestamp\": null,\n \"description\": null\n }\n },\n \"online\": {\n \"url\": \"https://registertovote.ca.gov/?t=s\",\n \"instructions\": \"You should know: you will need a California-issued driver license or California identification card number, the last four digits of your Social Security number, and consent to the use of your DMV-stored digital signature to use Californias online voter registration system. If you dont have a California-issued ID or dont want to provide consent for the use of your digital signature, you can still register by mail to vote.\",\n \"deadline\": {\n \"date\": \"2023-02-20\",\n \"timestamp\": null,\n \"description\": null\n }\n },\n \"byMail\": {\n \"idInstructions\": \"When you register to vote, you must provide your California driver's license or California identification card number, if you have one. If you do not have a driver's license or ID card, you must provide the last four digits of your Social Security number (SSN). If you
      do not include this information, you will be required to provide identification when you vote if it is your first time voting in a federal election.\",\n \"signatureInstructions\": \"To register in California you must:
      be a United States citizen
      be a resident of California
      be at least 18 years old or older on Election Day
      not be currently serving a state or federal prison term for the conviction of a felony
      not be currently found to be mentally incompetent to vote by a court\",\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:
      A current and valid photo identification or
      A current utility bill, bank statement, government check, paycheck or government document that shows your name and address.
      More information here.\",\n \"deadline\": {\n \"date\": \"2023-02-20\",\n \"timestamp\": null,\n \"description\": null,\n \"postmarkedOrReceived\": \"postmarked\"\n }\n }\n },\n \"questionAndAnswer\": {\n \"keyChangesElection\": {\n \"question\": null,\n \"answer\": null\n },\n \"voteInPerson\": {\n \"question\": null,\n \"answer\": null\n },\n \"whatsOnTheBallot\": {\n \"question\": null,\n \"answer\": null\n },\n \"stateContactInfo\": {\n \"question\": null,\n \"answer\": null\n },\n \"voteByMail\": {\n \"question\": \"How do I vote by mail?\",\n \"answer\": \"
      California mails a ballot to every registered voter a few weeks before the election. Keep an eye on the mailbox, and be sure to mail it back or drop it in a drop-box before Election Day.

      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.

      How do I return my ballot?

      • Read the instructions carefully on how to mark and return your ballot. After you have voted, insert your ballot in the envelope provided, making sure you complete all required information on the envelope.
      • You may return your voted ballot by mail, in person, or to a drop box.
      • If you are returning your ballot by mail, it must be postmarked on or before Election Day and received by your local election office no later than 7 days after Election Day. USPS recommends that voters mail their completed ballots at least one week before the due date. Find a USPS location near you.
      • If you are returning your ballot in person or dropping it in a drop box, it must be delivered no later than the close of polls at 8:00 p.m. on Election Day. Find your closest drop box on California's site.
      • Anyone may return your ballot for you, as long as they do not get paid on a per ballot basis. In order for your ballot to be counted, you must fill out the authorization section found on the outside of your ballot envelope.

      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 Californias site.
      \"\n },\n \"keyChanges\": {\n \"question\": \"What key changes should voters know about?\",\n \"answer\": \"
      Key changes to voting requirements in California:
      • California now conducts all elections primarily by mail. All active registered voters will receive a mail ballot.
      Learn more by visiting the California Secretary of State's website or contacting your local election office.
      \"\n },\n \"whoCanVote\": {\n \"question\": \"Who can register to vote?\",\n \"answer\": \"
      To register in California you must:
      • be a United States citizen
      • be a resident of California
      • be at least 18 years old or older on Election Day
      • not be currently serving a state or federal prison term for the conviction of a felony
      • not be currently found to be mentally incompetent to vote by a court
      \"\n },\n \"onlineVoterRegistration\": {\n \"question\": \"Can I register to vote online?\",\n \"answer\": \"
      • California offers online voter registration.
      • You should know: you will need a California-issued driver license or California identification card number, the last four digits of your Social Security number, and consent to the use of your DMV-stored digital signature to use Californias online voter registration system. If you dont have a California-issued ID or dont want to provide consent for the use of your digital signature, you can still register by mail to vote.


      \"\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: When you register to vote, you must provide your California driver's license or California identification card number, if you have one. If you do not have a driver's license or ID card, you must provide the last four digits of your Social Security number (SSN). If youdo not include this information, you will be required to provide identification when you vote if it is your first time voting in a federal election.
      3. Box 7 - Choice of Party: California does NOT require that you register with a party to participate in partisan primary elections. However some parties do not allow unaffiliated voters to participate in their partys presidential, local, or county committee primary elections.
      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:
        • A current and valid photo identification or
        • A 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\": \"California does offer in person registration on Election Day.\"\n },\n \"inPersonRegistration\": {\n \"question\": \"Can I submit voter registration forms in person?\",\n \"answer\": \"
      • You can also register to vote in person. Contact your local election office for information on when and where to register to vote. Conditional voter registration is a safety net for Californians who miss the deadline to register to vote or update their voter registration information. Voters can use the conditional voter registration process from the day after the deadline all the way through Election Day. Eligible citizens can go to their county election office, polling place, or vote center to register and vote conditionally. These ballots will be processed once the county elections office has completed the voter registration verification process.
      • You can also register to vote and cast a ballot in person on Election Day.
      • Learn more by visiting the California Secretary of State's website or contacting your local election office.
      \"\n },\n \"datesAndDeadlines\": {\n \"question\": \"What are key deadlines for this election?\",\n \"answer\": \"

      Registration deadlines

      Voting deadlines

      \"\n },\n \"voterId\": {\n \"question\": \"Do I need to bring an ID to vote in person?\",\n \"answer\": \"
      If you choose to vote in person and youve voted in California before, you dont need to show ID.

      If youre a first time voter in a federal election who registered by mail, and didnt include your drivers license number, California ID number, or the last 4 digits of your Social Security number on your registration, you may be asked to provide ID when you vote.

      Acceptable forms include:
      • copy of a recent utility bill
      • sample ballot booklet you received from your county elections office or another document sent to you by a government agency
      • US passport
      • driver license
      • official state identification card
      • student identification card showing your name and photograph

      Voters without ID: If you are unable to provide ID, you will be able to vote a provisional ballot.
      \"\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 California. 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 California's voter registration lookup tool.\"\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 }\n }\n ]\n },\n \"pagination\": {\n \"totalRecordCount\": 2,\n \"currentPage\": 1,\n \"pageSize\": 10\n }\n}", "cookie": [], "_postman_previewlanguage": "json" }, { "id": "617a300c-4d7b-487d-a757-3a80086111d6", "name": "Bad Request", "originalRequest": { "url": { "path": [ "elections" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "813%20Howard%20Street%20Oswego%20NY%2013126" }, { "key": "addressStreet", "value": "813%20Howard%20Street" }, { "key": "addressCity", "value": "Oswego" }, { "key": "addressStateCode", "value": "NY" }, { "key": "addressZip", "value": "13126" }, { "key": "addressZip4", "value": "9029" }, { "key": "stateCode", "value": "CA" }, { "key": "ocdId", "value": "ocd-division%2Fcountry%3Aus%2Fstate%3Any%2Fcounty%3Akings" }, { "key": "startDate", "value": "2023-01-01" }, { "key": "endDate", "value": "2023-01-02" }, { "key": "includeQuestionAndAnswer", "value": "true" }, { "key": "includeBallotData", "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": "9d8e6fc3-0e8c-4429-8ffb-0a24de7d6098", "name": "TooManyRequestsError", "originalRequest": { "url": { "path": [ "elections" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "813%20Howard%20Street%20Oswego%20NY%2013126" }, { "key": "addressStreet", "value": "813%20Howard%20Street" }, { "key": "addressCity", "value": "Oswego" }, { "key": "addressStateCode", "value": "NY" }, { "key": "addressZip", "value": "13126" }, { "key": "addressZip4", "value": "9029" }, { "key": "stateCode", "value": "CA" }, { "key": "ocdId", "value": "ocd-division%2Fcountry%3Aus%2Fstate%3Any%2Fcounty%3Akings" }, { "key": "startDate", "value": "2023-01-01" }, { "key": "endDate", "value": "2023-01-02" }, { "key": "includeQuestionAndAnswer", "value": "true" }, { "key": "includeBallotData", "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": "2c162238-eec0-4e7f-85e7-ce1a26fa5db9", "name": "InternalServerError", "originalRequest": { "url": { "path": [ "elections" ], "host": [ "{{baseUrl}}" ], "query": [ { "key": "address", "value": "813%20Howard%20Street%20Oswego%20NY%2013126" }, { "key": "addressStreet", "value": "813%20Howard%20Street" }, { "key": "addressCity", "value": "Oswego" }, { "key": "addressStateCode", "value": "NY" }, { "key": "addressZip", "value": "13126" }, { "key": "addressZip4", "value": "9029" }, { "key": "stateCode", "value": "CA" }, { "key": "ocdId", "value": "ocd-division%2Fcountry%3Aus%2Fstate%3Any%2Fcounty%3Akings" }, { "key": "startDate", "value": "2023-01-01" }, { "key": "endDate", "value": "2023-01-02" }, { "key": "includeQuestionAndAnswer", "value": "true" }, { "key": "includeBallotData", "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 } } ], "event": [] } ], "event": [], "variable": [ { "type": "string", "value": "https://api.democracy.works/v2", "key": "baseUrl" } ], "info": { "_postman_id": "759b30da-8f1b-42b1-9b67-54a30d764bef", "name": "Democracy Works Elections 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" } } }