Skip to content
23 days until Election Day, November 5, 2024

Civic Data API

The VoteAmerica Civic Data API provides state-by-state information about the laws governing elections in the United States. The available fields are listed below. Please see our docs for more information about using the API.

absentee_access_levelsThe highest level of absentee ballot access available to all votersSingle-selectexcuse_required, no_excuse, semi_permanent, permanent, universal
absentee_ballot_issuesGuidance for voters who signed up for an absentee ballot and now need to vote in personMarkdown
absentee_deadline_in_personThe deadline to request an absentee ballot in person relative to Election DayMarkdown
absentee_deadline_mailThe deadline to request an absentee ballot by-mail relative to Election DayMarkdown
absentee_deadline_onlineThe deadline to request an absentee ballot online relative to Election DayMarkdown
absentee_directions_mailStep-by-step directions for requesting an absentee ballot by-mailMarkdown
absentee_directions_onlineState-specific directions for requesting an absentee ballot onlineMarkdown
absentee_process_summaryA short overview for the absentee processMarkdown
absentee_request_methodsList of allowed methods for requesting an absentee ballotMulti-selectemail, fax, in_person, mail, online, phone
absentee_request_start_dateEarliest date to request an absentee ballot relative to Election DayMarkdown
absentee_voting_lawsLaws for voting by absentee ballotMarkdown
alerts_absenteeRecent changes related to absentee or mail voting. Generally positive (warnings house negative information).Markdown
alerts_registrationRecent changes related to registration. Generally positive (warnings house negative information).Markdown
ballot_curing_directionsThe steps a voter must take to cure a ballot that has been rejectedMarkdown
ballot_curing_laws_notification_processHow the state will let a voter know about an issue with their ballotMarkdown
ballot_curing_laws_rejection_reasonsA bulleted list of reasons why ballots may be rejectedMarkdown
ballot_return_deadline_in_personThe deadline to hand-deliver your absentee or mail ballot relative to Election DayMarkdown
ballot_return_deadline_mailThe deadline return your absentee or mail ballot via USPS relative to Election DayMarkdown
ballot_return_locationsList of allowed locations for returning an absentee or mail ballot (in addition to a mailbox)Multi-selectdrop_box, early_voting_site, local_election_office, polling_place
early_voting_endsWhen early voting ends relative to Election DayMarkdown
early_voting_startsWhen early voting starts relative to Election DayMarkdown
election_protection_phoneThe election protection hotline numberMarkdown
election_protection_websiteThe relevant page from 866ourvote.orgURL
emergency_ballot_lawsCircumstances in which an emergency ballot can be obtained.Markdown
emergency_ballot_request_deadlineLast day to request an emergency ballotMarkdown
emergency_ballot_return_deadlineIf specified this is the last day that an emergency ballot can be returned, otherwise the standard VBM deadline is used.Markdown
felony_laws_restoration_feesBulleted list of the type of fees a voter convicted of a felony will have to pay before voting rights can be restoredMarkdown
felony_laws_restoration_processDetails on voting rights restoration process for people with felony convictionsMarkdown
felony_voting_optionsList of situations in which people with felony convictions are allowed to voteMulti-selectimprisoned, parole, post_sentence, probation
fvap_uocava_directionsFVAP url that shows state-specific directionsURL
gov_tool_absentee_requestState absentee ballot request toolURL
gov_tool_absentee_trackerState absentee ballot tracker toolURL
gov_tool_polling_placeState polling place lookup toolURL
gov_tool_provisional_trackerState online provisional ballot tracker toolURL
gov_tool_registrationState online voter registration toolURL
gov_tool_uocavaLink to a state-specific tool for UOCAVA voters to use.URL
gov_tool_verifyState tool for verifying registration statusURL
has_automatic_registrationTrue if automatic voter registration existsBoolean
has_automatic_vbmTrue if all elections are held by mailBoolean
has_free_ballot_postageTrue if the state provides postage for voted ballotsBoolean
has_no_excuse_absenteeTrue if no excuse is needed to vote absenteeBoolean
has_pav_disabledTrue if disabled voters can sign up for permanent VBMBoolean
has_pav_elderlyTrue if elderly voters can sign up for permanent VBMBoolean
has_pav_everyoneTrue if anyone can sign up for permanent absentee ballotsBoolean
has_preregistrationTrue if the state allows individuals under 18 to initiate a registration process based on their current ageBoolean
has_sdr_early_votingState allows same day registration during the early voting periodBoolean
has_sdr_election_dayState allows same day registration on Election DayBoolean
id_laws_absentee_requestID requirements for absentee ballot requestsMarkdown
id_laws_ballot_returnID requirements for voted mail-in ballotsMarkdown
id_laws_in_person_votingID requirements for voting in personMarkdown
id_laws_online_registrationID requirements for online voter registrationMarkdown
id_laws_sdrID requirements for SDR and EDR.Markdown
id_laws_student_votersGuidance around using a student ID when votingMarkdown
id_type_ballot_returnThe type of identification required for returning a voted mail-in ballotSingle-selectnotarization, witness_signature, voter_signature
id_type_in_person_votingThe type of identification required when voting in personSingle-selectgovernment_photo_id, photo_id, id, hava_only
leo_absentee_ballotsLink to local election office contacts for absentee ballot informationURL
leo_overseas_votersLink to local election office contacts for overseas voter informationURL
leo_voter_registrationLink to local election office contacts for voter registration formsURL
minimum_age_registerMinimum age to register to vote. If null, the state does not specify and registration is allowed if the person will be 18 by the next major general electionMarkdown
nvra_directions_box6Directions for Box 6 (ID number) on the National Voter Registration ApplicationMarkdown
nvra_directions_box7Directions for Box 7 (choice of party) on the National Voter Registration ApplicationMarkdown
nvra_directions_box8Directions for Box 8 (race or ethnic group) on the National Voter Registration ApplicationMarkdown
nvra_submission_addressAddress to submit National Voter Registration ApplicationMarkdown
pav_directions_mailDirections for signing up for permanent absentee voting through mailMarkdown
pav_directions_onlineDirections for signing up for permanent absentee voting onlineMarkdown
pav_signup_methodsThe methods available to sign up for permanent absentee votingMulti-selectonline_absentee, online_register, mail_absentee, mail_register, mail_pav
pdf_absentee_formThe VoteAmerica URL for the form -- not the state website.URL
pdf_emergency_ballot_applicationLink to emergency ballot application PDF or specific form PDF to have another person retrieve an absentee ballot on behalf of a voter.URL
pdf_pav_formThe specific PDF used for mail-in permanent absentee voting sign upURL
pdf_register_formThe VoteAmerica URL for the voter registration form - not the state siteURL
polls_closeTime when polls close on Election DayMarkdown
polls_openTime when polls open on Election DayMarkdown
registration_deadline_in_personThe deadline to register to vote in person relative to Election DayMarkdown
registration_deadline_mailThe deadline to register to vote by mail relative to Election DayMarkdown
registration_deadline_onlineThe deadline to register to vote online relative to Election DayMarkdown
registration_directions_mailStep-by-step directions for registering to vote by mail (only used for states with special procedures)Markdown
registration_directions_onlineState-specific online voter registration directionsMarkdown
registration_lawsVoter registration lawsMarkdown
registration_methodsList of allowed methods for submitting voter registrationMulti-selectemail, fax, in_person, mail, online, phone
sdr_locationsSDR locationsMarkdown
sos_contact_emailStatewide election email. Generally the SOS.Markdown
sos_election_websiteStatewide election website. Generally the SOS.URL
sos_phone_numberStatewide election phone number. Generally the SOS.Markdown
source_absentee_infoSource of our absentee voting infoURL
source_early_voting_infoSource of our early voting infoURL
source_election_codeState election codeURL
source_registration_infoSource of our voter registration infoURL
source_rights_restoration_infoSource of our felon re-enfranchisement infoURL
source_student_voting_infoSource of our info for registering as a college studentURL
source_voter_id_infoSource of our voter ID infoURL
warnings_absenteeWarnings about recent changes related to absentee or mail voting. Generally negative (alerts house positive information).Markdown
warnings_registrationWarnings about recent changes related to registration. Generally negative (alerts house positive information).Markdown