Skip to content

Civic Data API

Version 2 of the VoteAmerica Civic Data API is now available. The available fields are listed below. Please see our docs for a guide to upgrading from Version 1 to Version 2.

Still on Version 1? Jump to the V1 field definitions.

SlugDescriptionField FormatOptions (only applicable for Multi-select fields)
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 elderly or disabled voters can sign up for permanent VBMBoolean
has_pav_everyoneTrue if anyone can sign up for permanent absentee ballotsBoolean
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
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 voteMarkdown
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
pdf_absentee_formThe github URL for the form -- not the state websites.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
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

Version 1 fields (deprecated)

The Version 1 fields are listed below:
SlugDescriptionField Format
alert_registrationRecent changes related to registration. Generally positive (warnings house negative information).Markdown
alert_vbmRecent changes related to absentee or mail voting. Generally positive (warnings house negative information).Markdown
ballot_curing_correction_processThe steps a voter must take to cure a ballot that has been rejectedMarkdown
ballot_curing_instructionsA bulleted list of reasons why ballots may be rejectedMarkdown
ballot_curing_notification_processHow the state will let a voter know about an issue with their ballotMarkdown
early_votingDEPRECATEDBoolean
early_voting_endsWhen early voting ends relative to Election DayMarkdown
early_voting_notesNotes related to early voting.Markdown
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_applicationLink to emergency ballot application PDF or specific form PDF to have another person retrieve an absentee ballot on behalf of a voter.URL
emergency_ballot_lawDEPRECATEDMarkdown
emergency_ballot_request_endLast day to request an emergency ballotMarkdown
emergency_ballot_request_startFirst day that an emergency ballot can be requestedMarkdown
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
emergency_ballot_rulesCircumstances in which an emergency ballot can be obtained.Markdown
emergency_ballot_votingIndicates whether emergency ballots are available in cases where the absentee request deadline has passed and the voter is experiencing a medical or other personal emergencyBoolean
external_tool_absentee_ballot_trackerState absentee ballot tracker toolURL
external_tool_felony_restoration_state_infoDEPRECATEDURL
external_tool_ovrState online voter registration toolURL
external_tool_polling_placeState polling place lookup toolURL
external_tool_provisional_ballot_trackerState online provisional ballot tracker toolURL
external_tool_vbm_applicationState absentee ballot request toolURL
external_tool_vbm_application_requires_printingTrue if voters need to print the form prepared by the state's OVBM toolBoolean
external_tool_vbm_has_regional_urlsTrue if the state has multiple regional tools for requesting vote-by-mail ballotsBoolean
external_tool_verify_statusState tool for verifying registration statusURL
felon_vote_feesBulleted list of the type of fees a voter convicted of a felony will have to pay before voting rights can be restoredMarkdown
felon_vote_in_prisonCan people vote while in prison?Boolean
felon_vote_notesNotes on recent law changes or special instructions for restoring voting rights after a felony convictionMarkdown
felon_vote_paroleCan people vote while on parole?Boolean
felon_vote_post_sentenceCan people vote when their sentence is completed?Boolean
felon_vote_probationCan people vote while on probation?Boolean
felon_vote_release_prisonDEPRECATEDBoolean
felon_vote_restorationDetails on voting rights restoration process for people with felony convictionsMarkdown
felon_vote_supervisionDEPRECATEDBoolean
id_laws_out_of_state_acceptedTrue if a state will accept an out-of-state IDBoolean
id_laws_student_id_acceptedDEPRECATED.Boolean
id_requirements_in_person_registrationID requirements for in person voter registrationMarkdown
id_requirements_in_person_votingID requirements for voting in personMarkdown
id_requirements_ovrID requirements for online voter registrationMarkdown
id_requirements_sdrID requirements for SDR and EDR.Markdown
id_requirements_studentsGuidance around using a student ID when votingMarkdown
id_requirements_vbm_requestID requirements for absentee ballot requestsMarkdown
id_requirements_vbm_returnID requirements for voted mail-in ballotsMarkdown
in_person_absentee_votingDEPRECATEDBoolean
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
military_votingDEPRECATEDBoolean
official_info_early_votingSource of our early voting infoURL
official_info_felonSource of our felon re-enfranchisement infoURL
official_info_registrationSource of our voter registration infoURL
official_info_studentsSource of our info for registering as a college studentURL
official_info_vbmSource of our absentee voting infoURL
official_info_voter_idSource of our voter ID infoURL
overseas_fvap_directionsFVAP url that shows state-specific directionsURL
overseas_fvap_toolFVAP state-specific URLURL
overseas_votingDEPRECATEDBoolean
pdf_absentee_formThe github URL for the form -- not the state websites.URL
polling_place_votingDEPRECATEDBoolean
polls_closeTime when polls close on Election DayMarkdown
polls_openTime when polls open on Election DayMarkdown
provisional_votingProvisional ballot voting allowedBoolean
registration_automatic_existsTrue if automatic voter registration existsBoolean
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_felony_convictionhelp text for folks with felony convictions.Markdown
registration_directions_mailStep-by-step directions for registering to vote by mail (only used for states with special procedures)Markdown
registration_minimum_ageMinimum age to register to voteMarkdown
registration_nvrf_box_6Directions for Box 6 (ID number) on the National Voter Registration ApplicationMarkdown
registration_nvrf_box_7Directions for Box 7 (choice of party) on the National Voter Registration ApplicationMarkdown
registration_nvrf_box_8Directions for Box 8 (race or ethnic group) on the National Voter Registration ApplicationMarkdown
registration_nvrf_submission_addressAddress to submit National Voter Registration ApplicationMarkdown
registration_ovr_directionsState-specific online voter registration directionsMarkdown
registration_rulesVoter registration lawsMarkdown
registration_submission_emailTrue if you can submit your registration form via emailBoolean
registration_submission_faxTrue if you can submit your form via faxBoolean
registration_submission_in_personTrue if you can register to vote in personBoolean
registration_submission_mailTrue if you can submit your form via mailBoolean
registration_submission_phoneTrue if you can register to vote via phoneBoolean
sdr_early_votingState allows same day registration during the early voting periodBoolean
sdr_election_dayState allows same day registration on Election DayBoolean
sdr_notesSame Day Registration (notes)Markdown
sdr_whereSDR 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
specific_ballot_drop_dateBallot drop dateDate
specific_ballot_return_deadline_by_mailBallot return deadline (mail)Markdown
specific_ballot_return_deadline_in_personBallot return deadline (in-person)Date
specific_early_voting_endsEarly voting end dateDate
specific_early_voting_startsEarly voting state dartDate
specific_general_election_dateGeneral election dateDate
specific_minimum_dobDOB cutoff to register for the Nov 8 2022 electionDate
specific_official_election_calendarStatewide official election calendarURL
specific_registration_deadline_by_mailVoter registration deadline (mail)Date
specific_registration_deadline_in_personVoter registration deadline (in-person)Date
specific_registration_deadline_onlineVoter registration deadline (online)Date
specific_vbm_request_deadline_by_in_personAbsentee request deadline (in-person)Date
specific_vbm_request_deadline_by_mailAbsentee request deadline (mail)Date
specific_vbm_request_deadline_onlineAbsentee request deadline (online)Date
state_election_codeState election codeURL
vbm_absentee_ballot_rulesLaws for voting by absentee ballotMarkdown
vbm_app_submission_emailVBM - can you submit your app via email?Boolean
vbm_app_submission_faxVBM - can you submit your app via fax?Boolean
vbm_app_submission_in_personVBM - can you submit your app in person?Boolean
vbm_app_submission_mailVBM - can you submit your app via mail?Boolean
vbm_app_submission_phoneTrue if you can request an absentee ballot via phoneBoolean
vbm_counties_provides_dropboxesTrue if the county provides VBM dropboxesBoolean
vbm_deadline_in_personThe deadline to request an absentee ballot in person relative to Election DayMarkdown
vbm_deadline_mailThe deadline to request an absentee ballot by-mail relative to Election DayMarkdown
vbm_deadline_onlineThe deadline to request an absentee ballot online relative to Election DayMarkdown
vbm_excuse_neededDEPRECATEDBoolean
vbm_first_day_to_applyEarliest date to request an absentee ballot relative to Election DayMarkdown
vbm_no_excuseTrue if no excuse is needed to vote absenteeBoolean
vbm_notesvbm_notesMarkdown
vbm_other_optionsGuidance for voters who signed up for an absentee ballot and now need to vote in personMarkdown
vbm_ovbm_directionsState-specific directions for requesting an absentee ballot onlineMarkdown
vbm_overviewA short overview for the absentee processMarkdown
vbm_permanent_anyoneTrue if anyone can sign up for permanent absentee ballotsBoolean
vbm_permanent_disabledTrue if elderly or disabled voters can sign up for permanent VBMBoolean
vbm_request_directions_mailStep-by-step directions for requesting an absentee ballot by-mailMarkdown
vbm_return_drop_boxBallot can be returned via drop boxBoolean
vbm_return_early_votingBallot can be returned to an early voting locationBoolean
vbm_return_election_officeBallot returned in person to election officeBoolean
vbm_return_hand_deliver_allowedTrue if you can hand-deliver your mail-in ballot.Boolean
vbm_return_polling_placeBallot can be hand delivered to polling locationBoolean
vbm_state_provides_ballot_postageTrue if the state provides postage for voted ballotsBoolean
vbm_state_provides_dropboxesTrue of the state provides VBM dropboxesBoolean
vbm_universalTrue if all elections are held by mailBoolean
vbm_voted_ballot_deadline_in_personThe deadline to hand-deliver your absentee or mail ballot relative to Election DayMarkdown
vbm_voted_ballot_deadline_mailThe deadline return your absentee or mail ballot via USPS relative to Election DayMarkdown
vbm_warningsWarnings 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