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.
Civic Data API
Still on Version 1? Jump to the V1 field definitions.
Slug | Description | Field Format | Options (only applicable for Multi-select fields) |
---|---|---|---|
absentee_ballot_issues | Guidance for voters who signed up for an absentee ballot and now need to vote in person | Markdown | |
absentee_deadline_in_person | The deadline to request an absentee ballot in person relative to Election Day | Markdown | |
absentee_deadline_mail | The deadline to request an absentee ballot by-mail relative to Election Day | Markdown | |
absentee_deadline_online | The deadline to request an absentee ballot online relative to Election Day | Markdown | |
absentee_directions_mail | Step-by-step directions for requesting an absentee ballot by-mail | Markdown | |
absentee_directions_online | State-specific directions for requesting an absentee ballot online | Markdown | |
absentee_process_summary | A short overview for the absentee process | Markdown | |
absentee_request_methods | List of allowed methods for requesting an absentee ballot | Multi-select | email, fax, in_person, mail, online, phone |
absentee_request_start_date | Earliest date to request an absentee ballot relative to Election Day | Markdown | |
absentee_voting_laws | Laws for voting by absentee ballot | Markdown | |
alerts_absentee | Recent changes related to absentee or mail voting. Generally positive (warnings house negative information). | Markdown | |
alerts_registration | Recent changes related to registration. Generally positive (warnings house negative information). | Markdown | |
ballot_curing_directions | The steps a voter must take to cure a ballot that has been rejected | Markdown | |
ballot_curing_laws_notification_process | How the state will let a voter know about an issue with their ballot | Markdown | |
ballot_curing_laws_rejection_reasons | A bulleted list of reasons why ballots may be rejected | Markdown | |
ballot_return_deadline_in_person | The deadline to hand-deliver your absentee or mail ballot relative to Election Day | Markdown | |
ballot_return_deadline_mail | The deadline return your absentee or mail ballot via USPS relative to Election Day | Markdown | |
ballot_return_locations | List of allowed locations for returning an absentee or mail ballot (in addition to a mailbox) | Multi-select | drop_box, early_voting_site, local_election_office, polling_place |
early_voting_ends | When early voting ends relative to Election Day | Markdown | |
early_voting_starts | When early voting starts relative to Election Day | Markdown | |
election_protection_phone | The election protection hotline number | Markdown | |
election_protection_website | The relevant page from 866ourvote.org | URL | |
emergency_ballot_laws | Circumstances in which an emergency ballot can be obtained. | Markdown | |
emergency_ballot_request_deadline | Last day to request an emergency ballot | Markdown | |
emergency_ballot_return_deadline | If specified this is the last day that an emergency ballot can be returned, otherwise the standard VBM deadline is used. | Markdown | |
felony_laws_restoration_fees | Bulleted list of the type of fees a voter convicted of a felony will have to pay before voting rights can be restored | Markdown | |
felony_laws_restoration_process | Details on voting rights restoration process for people with felony convictions | Markdown | |
felony_voting_options | List of situations in which people with felony convictions are allowed to vote | Multi-select | imprisoned, parole, post_sentence, probation |
fvap_uocava_directions | FVAP url that shows state-specific directions | URL | |
gov_tool_absentee_request | State absentee ballot request tool | URL | |
gov_tool_absentee_tracker | State absentee ballot tracker tool | URL | |
gov_tool_polling_place | State polling place lookup tool | URL | |
gov_tool_provisional_tracker | State online provisional ballot tracker tool | URL | |
gov_tool_registration | State online voter registration tool | URL | |
gov_tool_uocava | Link to a state-specific tool for UOCAVA voters to use. | URL | |
gov_tool_verify | State tool for verifying registration status | URL | |
has_automatic_registration | True if automatic voter registration exists | Boolean | |
has_automatic_vbm | True if all elections are held by mail | Boolean | |
has_free_ballot_postage | True if the state provides postage for voted ballots | Boolean | |
has_no_excuse_absentee | True if no excuse is needed to vote absentee | Boolean | |
has_pav_disabled | True if elderly or disabled voters can sign up for permanent VBM | Boolean | |
has_pav_everyone | True if anyone can sign up for permanent absentee ballots | Boolean | |
has_sdr_early_voting | State allows same day registration during the early voting period | Boolean | |
has_sdr_election_day | State allows same day registration on Election Day | Boolean | |
id_laws_absentee_request | ID requirements for absentee ballot requests | Markdown | |
id_laws_ballot_return | ID requirements for voted mail-in ballots | Markdown | |
id_laws_in_person_voting | ID requirements for voting in person | Markdown | |
id_laws_online_registration | ID requirements for online voter registration | Markdown | |
id_laws_sdr | ID requirements for SDR and EDR. | Markdown | |
id_laws_student_voters | Guidance around using a student ID when voting | Markdown | |
leo_absentee_ballots | Link to local election office contacts for absentee ballot information | URL | |
leo_overseas_voters | Link to local election office contacts for overseas voter information | URL | |
leo_voter_registration | Link to local election office contacts for voter registration forms | URL | |
minimum_age_register | Minimum age to register to vote | Markdown | |
nvra_directions_box6 | Directions for Box 6 (ID number) on the National Voter Registration Application | Markdown | |
nvra_directions_box7 | Directions for Box 7 (choice of party) on the National Voter Registration Application | Markdown | |
nvra_directions_box8 | Directions for Box 8 (race or ethnic group) on the National Voter Registration Application | Markdown | |
nvra_submission_address | Address to submit National Voter Registration Application | Markdown | |
pdf_absentee_form | The github URL for the form -- not the state websites. | URL | |
pdf_emergency_ballot_application | Link to emergency ballot application PDF or specific form PDF to have another person retrieve an absentee ballot on behalf of a voter. | URL | |
polls_close | Time when polls close on Election Day | Markdown | |
polls_open | Time when polls open on Election Day | Markdown | |
registration_deadline_in_person | The deadline to register to vote in person relative to Election Day | Markdown | |
registration_deadline_mail | The deadline to register to vote by mail relative to Election Day | Markdown | |
registration_deadline_online | The deadline to register to vote online relative to Election Day | Markdown | |
registration_directions_mail | Step-by-step directions for registering to vote by mail (only used for states with special procedures) | Markdown | |
registration_directions_online | State-specific online voter registration directions | Markdown | |
registration_laws | Voter registration laws | Markdown | |
registration_methods | List of allowed methods for submitting voter registration | Multi-select | email, fax, in_person, mail, online, phone |
sdr_locations | SDR locations | Markdown | |
sos_contact_email | Statewide election email. Generally the SOS. | Markdown | |
sos_election_website | Statewide election website. Generally the SOS. | URL | |
sos_phone_number | Statewide election phone number. Generally the SOS. | Markdown | |
source_absentee_info | Source of our absentee voting info | URL | |
source_early_voting_info | Source of our early voting info | URL | |
source_election_code | State election code | URL | |
source_registration_info | Source of our voter registration info | URL | |
source_rights_restoration_info | Source of our felon re-enfranchisement info | URL | |
source_student_voting_info | Source of our info for registering as a college student | URL | |
source_voter_id_info | Source of our voter ID info | URL | |
warnings_absentee | Warnings about recent changes related to absentee or mail voting. Generally negative (alerts house positive information). | Markdown | |
warnings_registration | Warnings about recent changes related to registration. Generally negative (alerts house positive information). | Markdown |
Version 1 fields (deprecated)
The Version 1 fields are listed below:
Slug | Description | Field Format |
---|---|---|
alert_registration | Recent changes related to registration. Generally positive (warnings house negative information). | Markdown |
alert_vbm | Recent changes related to absentee or mail voting. Generally positive (warnings house negative information). | Markdown |
ballot_curing_correction_process | The steps a voter must take to cure a ballot that has been rejected | Markdown |
ballot_curing_instructions | A bulleted list of reasons why ballots may be rejected | Markdown |
ballot_curing_notification_process | How the state will let a voter know about an issue with their ballot | Markdown |
early_voting | DEPRECATED | Boolean |
early_voting_ends | When early voting ends relative to Election Day | Markdown |
early_voting_notes | Notes related to early voting. | Markdown |
early_voting_starts | When early voting starts relative to Election Day | Markdown |
election_protection_phone | The election protection hotline number | Markdown |
election_protection_website | The relevant page from 866ourvote.org | URL |
emergency_ballot_application | Link 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_law | DEPRECATED | Markdown |
emergency_ballot_request_end | Last day to request an emergency ballot | Markdown |
emergency_ballot_request_start | First day that an emergency ballot can be requested | Markdown |
emergency_ballot_return_deadline | If specified this is the last day that an emergency ballot can be returned, otherwise the standard VBM deadline is used. | Markdown |
emergency_ballot_rules | Circumstances in which an emergency ballot can be obtained. | Markdown |
emergency_ballot_voting | Indicates whether emergency ballots are available in cases where the absentee request deadline has passed and the voter is experiencing a medical or other personal emergency | Boolean |
external_tool_absentee_ballot_tracker | State absentee ballot tracker tool | URL |
external_tool_felony_restoration_state_info | DEPRECATED | URL |
external_tool_ovr | State online voter registration tool | URL |
external_tool_polling_place | State polling place lookup tool | URL |
external_tool_provisional_ballot_tracker | State online provisional ballot tracker tool | URL |
external_tool_vbm_application | State absentee ballot request tool | URL |
external_tool_vbm_application_requires_printing | True if voters need to print the form prepared by the state's OVBM tool | Boolean |
external_tool_vbm_has_regional_urls | True if the state has multiple regional tools for requesting vote-by-mail ballots | Boolean |
external_tool_verify_status | State tool for verifying registration status | URL |
felon_vote_fees | Bulleted list of the type of fees a voter convicted of a felony will have to pay before voting rights can be restored | Markdown |
felon_vote_in_prison | Can people vote while in prison? | Boolean |
felon_vote_notes | Notes on recent law changes or special instructions for restoring voting rights after a felony conviction | Markdown |
felon_vote_parole | Can people vote while on parole? | Boolean |
felon_vote_post_sentence | Can people vote when their sentence is completed? | Boolean |
felon_vote_probation | Can people vote while on probation? | Boolean |
felon_vote_release_prison | DEPRECATED | Boolean |
felon_vote_restoration | Details on voting rights restoration process for people with felony convictions | Markdown |
felon_vote_supervision | DEPRECATED | Boolean |
id_laws_out_of_state_accepted | True if a state will accept an out-of-state ID | Boolean |
id_laws_student_id_accepted | DEPRECATED. | Boolean |
id_requirements_in_person_registration | ID requirements for in person voter registration | Markdown |
id_requirements_in_person_voting | ID requirements for voting in person | Markdown |
id_requirements_ovr | ID requirements for online voter registration | Markdown |
id_requirements_sdr | ID requirements for SDR and EDR. | Markdown |
id_requirements_students | Guidance around using a student ID when voting | Markdown |
id_requirements_vbm_request | ID requirements for absentee ballot requests | Markdown |
id_requirements_vbm_return | ID requirements for voted mail-in ballots | Markdown |
in_person_absentee_voting | DEPRECATED | Boolean |
leo_absentee_ballots | Link to local election office contacts for absentee ballot information | URL |
leo_overseas_voters | Link to local election office contacts for overseas voter information | URL |
leo_voter_registration | Link to local election office contacts for voter registration forms | URL |
military_voting | DEPRECATED | Boolean |
official_info_early_voting | Source of our early voting info | URL |
official_info_felon | Source of our felon re-enfranchisement info | URL |
official_info_registration | Source of our voter registration info | URL |
official_info_students | Source of our info for registering as a college student | URL |
official_info_vbm | Source of our absentee voting info | URL |
official_info_voter_id | Source of our voter ID info | URL |
overseas_fvap_directions | FVAP url that shows state-specific directions | URL |
overseas_fvap_tool | FVAP state-specific URL | URL |
overseas_voting | DEPRECATED | Boolean |
pdf_absentee_form | The github URL for the form -- not the state websites. | URL |
polling_place_voting | DEPRECATED | Boolean |
polls_close | Time when polls close on Election Day | Markdown |
polls_open | Time when polls open on Election Day | Markdown |
provisional_voting | Provisional ballot voting allowed | Boolean |
registration_automatic_exists | True if automatic voter registration exists | Boolean |
registration_deadline_in_person | The deadline to register to vote in person relative to Election Day | Markdown |
registration_deadline_mail | The deadline to register to vote by mail relative to Election Day | Markdown |
registration_deadline_online | The deadline to register to vote online relative to Election Day | Markdown |
registration_directions_felony_conviction | help text for folks with felony convictions. | Markdown |
registration_directions_mail | Step-by-step directions for registering to vote by mail (only used for states with special procedures) | Markdown |
registration_minimum_age | Minimum age to register to vote | Markdown |
registration_nvrf_box_6 | Directions for Box 6 (ID number) on the National Voter Registration Application | Markdown |
registration_nvrf_box_7 | Directions for Box 7 (choice of party) on the National Voter Registration Application | Markdown |
registration_nvrf_box_8 | Directions for Box 8 (race or ethnic group) on the National Voter Registration Application | Markdown |
registration_nvrf_submission_address | Address to submit National Voter Registration Application | Markdown |
registration_ovr_directions | State-specific online voter registration directions | Markdown |
registration_rules | Voter registration laws | Markdown |
registration_submission_email | True if you can submit your registration form via email | Boolean |
registration_submission_fax | True if you can submit your form via fax | Boolean |
registration_submission_in_person | True if you can register to vote in person | Boolean |
registration_submission_mail | True if you can submit your form via mail | Boolean |
registration_submission_phone | True if you can register to vote via phone | Boolean |
sdr_early_voting | State allows same day registration during the early voting period | Boolean |
sdr_election_day | State allows same day registration on Election Day | Boolean |
sdr_notes | Same Day Registration (notes) | Markdown |
sdr_where | SDR locations | Markdown |
sos_contact_email | Statewide election email. Generally the SOS. | Markdown |
sos_election_website | Statewide election website. Generally the SOS. | URL |
sos_phone_number | Statewide election phone number. Generally the SOS. | Markdown |
specific_ballot_drop_date | Ballot drop date | Date |
specific_ballot_return_deadline_by_mail | Ballot return deadline (mail) | Markdown |
specific_ballot_return_deadline_in_person | Ballot return deadline (in-person) | Date |
specific_early_voting_ends | Early voting end date | Date |
specific_early_voting_starts | Early voting state dart | Date |
specific_general_election_date | General election date | Date |
specific_minimum_dob | DOB cutoff to register for the Nov 8 2022 election | Date |
specific_official_election_calendar | Statewide official election calendar | URL |
specific_registration_deadline_by_mail | Voter registration deadline (mail) | Date |
specific_registration_deadline_in_person | Voter registration deadline (in-person) | Date |
specific_registration_deadline_online | Voter registration deadline (online) | Date |
specific_vbm_request_deadline_by_in_person | Absentee request deadline (in-person) | Date |
specific_vbm_request_deadline_by_mail | Absentee request deadline (mail) | Date |
specific_vbm_request_deadline_online | Absentee request deadline (online) | Date |
state_election_code | State election code | URL |
vbm_absentee_ballot_rules | Laws for voting by absentee ballot | Markdown |
vbm_app_submission_email | VBM - can you submit your app via email? | Boolean |
vbm_app_submission_fax | VBM - can you submit your app via fax? | Boolean |
vbm_app_submission_in_person | VBM - can you submit your app in person? | Boolean |
vbm_app_submission_mail | VBM - can you submit your app via mail? | Boolean |
vbm_app_submission_phone | True if you can request an absentee ballot via phone | Boolean |
vbm_counties_provides_dropboxes | True if the county provides VBM dropboxes | Boolean |
vbm_deadline_in_person | The deadline to request an absentee ballot in person relative to Election Day | Markdown |
vbm_deadline_mail | The deadline to request an absentee ballot by-mail relative to Election Day | Markdown |
vbm_deadline_online | The deadline to request an absentee ballot online relative to Election Day | Markdown |
vbm_excuse_needed | DEPRECATED | Boolean |
vbm_first_day_to_apply | Earliest date to request an absentee ballot relative to Election Day | Markdown |
vbm_no_excuse | True if no excuse is needed to vote absentee | Boolean |
vbm_notes | vbm_notes | Markdown |
vbm_other_options | Guidance for voters who signed up for an absentee ballot and now need to vote in person | Markdown |
vbm_ovbm_directions | State-specific directions for requesting an absentee ballot online | Markdown |
vbm_overview | A short overview for the absentee process | Markdown |
vbm_permanent_anyone | True if anyone can sign up for permanent absentee ballots | Boolean |
vbm_permanent_disabled | True if elderly or disabled voters can sign up for permanent VBM | Boolean |
vbm_request_directions_mail | Step-by-step directions for requesting an absentee ballot by-mail | Markdown |
vbm_return_drop_box | Ballot can be returned via drop box | Boolean |
vbm_return_early_voting | Ballot can be returned to an early voting location | Boolean |
vbm_return_election_office | Ballot returned in person to election office | Boolean |
vbm_return_hand_deliver_allowed | True if you can hand-deliver your mail-in ballot. | Boolean |
vbm_return_polling_place | Ballot can be hand delivered to polling location | Boolean |
vbm_state_provides_ballot_postage | True if the state provides postage for voted ballots | Boolean |
vbm_state_provides_dropboxes | True of the state provides VBM dropboxes | Boolean |
vbm_universal | True if all elections are held by mail | Boolean |
vbm_voted_ballot_deadline_in_person | The deadline to hand-deliver your absentee or mail ballot relative to Election Day | Markdown |
vbm_voted_ballot_deadline_mail | The deadline return your absentee or mail ballot via USPS relative to Election Day | Markdown |
vbm_warnings | Warnings about recent changes related to absentee or mail voting. Generally negative (alerts house positive information). | Markdown |
warnings_registration | Warnings about recent changes related to registration. Generally negative (alerts house positive information). | Markdown |