Search

TurboVote User Account Data Dictionary

  • Updated

TurboVote user data fields provide individual-level data related to TurboVote’s voter registration assistance, check your registration, election reminders, request mail ballot, and sample ballot signup experiences. Partners can export user account data via the Admin Console as well as the TurboVote Bulk Export API. 

Note: Data fields available for Youth User Accounts created to pre-register to vote are detailed below.

We include field names for User Export and Webhooks as available. Read on for a description of each data field.

Updated: 2026-04-13

 

User Account Profile

Name

Legal Name

Export field: first_name, middle_name, last_name

Webhook event field: firstName, middleName, lastName

Information: This field shows a user’s legal name.

Value: First name, middle name, last name

Example: David Samuel Cortez

 

Preferred Name

Export field: preferred_name

Webhook event field: preferredName

Information: This field shows a user’s preferred name. Within TurboVote, users must provide their legal first name, but they also have the option to provide a nickname. This preferred name is used in all TurboVote-generated experiences instead of the first name. If a user provides a nickname during signup, the preferred name column is populated with that name. Otherwise, it is populated with the user’s provided legal first name. 

Value example: Sammy

 

Contact Information

Contact Methods

Export fields: phone,email

Webhook event field: phone, email

Information: During the signup process, users have the option of providing their phone number, email address, or both. 

Value examples: 888-090-4447, dscortez1113@gmail.com

 

Contact Subscriptions

Export fields: email_subscribed, sms_subscribed

Webhook event field: n/a

Information: These fields indicate whether the user will receive TurboVote election reminders via email and text.

Values: TRUE or FALSE

 

Partner Communications Checkbox

Export fields: partner_comms_opt_in

Webhook event field: partnerCommsOptIn

Information: The partner communications checkbox can be added to all TurboVote sign-up forms (e.g., /register-to-vote/voter-info, /check-your-registration/voter-info, /reminders/voter-info and /preregister/voter-info). It gives users the option to check a box according to the custom language next to the checkbox. To add this feature to your site, please submit the customizations request form.

Values: If TRUE, this field indicates that a user says “yes” to the custom language. FALSE and a blank cell both indicate that the user has not opted-in to the custom language.

 

Address

Registered Address

Export fields: registered_address_street, registered_address_street-2, registered_address_city, registered_address_state, registered_address_zip

Webhook event field: registeredAddress (event node name), line1, line2, city, state, zip

Information: These fields record where users have indicated they live, for the purpose of voting. A user’s registration address may be the same as their mailing address, but it could differ for a variety of reasons. For example, a user’s voter registration address must be a physical street address. Using this data, partners can evaluate in which states and localities users are deciding to cast their ballots.  

Value example: 20 Jay Street, Suite 410, Brooklyn NY, 11201
 

 

Registered Address OCD-IDs

Export field: registered_address_ocd_ids

Webhook event field: none

Information: This field indicates the Open Civic Data Identifiers (OCD-IDs) associated with the user’s registered address.

Value: string

Example:

ocd-division/country:us/state:oh ocd-division/country:us/state:oh/sldu:27
ocd-division/country:us/state:oh/county:summit ocd-division/country:us/state:oh/place:fairlawn
ocd-division/country:us/state:oh/county:summit/school_district:copley-fairlawn_city
ocd-division/country:us ocd-division/country:us/state:oh/sldl:31
ocd-division/country:us/state:oh/cd:13

 

Mailing Address

Export fields: mailing_address_street, mailing_address_street-2, mailing_address_city, mailing_address_state, mailing_address_zip

Webhook event field: mailingAddress (event node name), line1, line2, city, state, zip

Information: These fields record where users have opted to receive mail. Capturing the correct mailing address is an important part of the TurboVote signup process, especially for users registering to vote with an address that is not their mailing address (i.e. out-of-state students choosing to register back home), or voting by mail. For example, college/university partners can use data from these fields to track the proper input of campus mailroom P.O. Boxes.

Value example: 20 Jay Street, Suite 410, Brooklyn NY, 11201

 

Mailings Subscription

Export field: mailings_subscribed

Webhook event field: n/a

Information: If your TurboVote site includes sponsored mailings, this field is present and indicates whether the user is subscribed to TurboVote mailings.

Values: TRUE or FALSE

 

Birthdates

Accounts for users who signed up for TurboVote prior to Spring 2024 (when sign-up forms were consolidated require date of birth) may not include a date or year of birth.

 

Date of Birth

Export field: date_of_birth

Webhook event field: dateOfBirth

Information: This field allows partners to track the age range of their users. Users who sign up with TurboVote input their full date of birth during the signup process.

Value: YYYY-MM-DD

Example: 1990-12-31

 

Year of Birth

Export field: dob

Webhook event field: n/a (Webhook event shares dateOfBirth YYYY-MM-DD)

Information: This field allows partners to track the age range of their users. Users who sign up with TurboVote input their full date of birth during the signup process.

Value: YYYY

Example: 1990

 

Language Preference

Export field: language_preference

Webhook event field: languagePreference

Information: This field indicates whether TurboVote uses English or Spanish when interacting with the user.

Values: en or es

 

TurboVote Identifiers

I.D.

Export field: id

Webhook Event Field: id

Information: Unique identifying number for each user primarily used by the TurboVote system. These strings of letters, numbers, and symbols can be helpful for reporting individual user questions back to TurboVote or for discussing users in an anonymized/privacy-preserving way. For the most part, you are unlikely to use the data in this field.

 

Personalization ID

Field: personalization-id

Webhook Event Field: personalizationId

Information: Unique identifying number for each user primarily used by the TurboVote system used to personalize inbound links to TurboVote for existing users to view election guides or check their registration status. 

For example, this URL shows personalized registration status results for a demonstration account https://example.turbovote.org/check-your-registration/status?user=Zh_gBG5LQQCwbP_7b7AH3Q. 

You can assemble your own personalized links using this URL template: 

https://{hostname}.turbovote.org/check-your-registration/status?user={personalizationId}.

Value example: ZjuYIWj1Q-epqZzgv04Mrw

 

External Identifiers

Voterbase ID

Field: voterbase_id

Webhook Event Field: voterbaseId

Information: Unique identifier (ID) for Targetsmart VoterBase records returned via TargetSmart Voter Registration Service database of registered voters on checking voter registration status via TurboVote.

Value example: AK-12345678

 

Voterbase ID Timestamp

Field: voterbase_checked_at

Webhook Event Field: voterbaseCheckedAt

Information: Date when user’s Targetsmart VoterBase record was checked via TargetSmart Voter Registration Service database of registered voters on checking voter registration status via TurboVote.

Value example: 2024-03-01

 

Account Creation

Created At

Export field: created_at 

Webhook event field: createdAt

Information: This field captures the date and time TurboVote created a record for the user. This can be useful for determining which times of the year experience the most successful implementation. Timestamps are recorded in Coordinated Universal Time (UTC) and listed in chronological order. 

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2024-08-01 03:45:22

 

Partner Hostname

Export field: hostname

Webhook event field: n/a

Information: This field shows the URL through which the user signed up. 

Value: [partner].turbovote.org

Example: myfaithvotes.turbovote.org

 

Referral Code

Export field: referral_code 

Webhook event field: referralCode

Information: Referral links are useful for tracking the effectiveness of different forms of outreach. This field captures the unique referral code through which the user signed up. If the field is blank, the user came through the standard partner URL, not one with a referral code. For more information about referral codes, visit the TurboVote Help Center.

 

Embed Placement Code 

Export field: embed_placement

Webhook event field: embedPlacement

Information: Leveraged by partners integrating TurboVote Embeds into various pages of their website, this field captures the code partners can assign to a specific embed placement on their website (e.g. homepage, check-registration-page).

Value example: tv-hub

 

Partner-Provided Metadata

Export field: partner_metadata_account

Webhook event field: metadata

Information: This field captures the up to 50 key/value pairs associated with a newly created account when appended to any inbound link to TurboVote. Learn more about Associating Metadata with TurboVote Accounts.

To avoid conflicts with any existing query parameters on a given website, partners are required to prefix keys with x-. (e.g. x-partnerUserId=12345abscde) when appending to inbound URLs. This prefix is not included when key/value pairs are shared via export or webhook. 

For example, if a user clicked a URL with a metadata-bearing query parameter like this: https://{partner-hostname}.turbovote.org/check-your-registration/voter-info?x-partnerUserId=12345abscde and created a TurboVote account, the export CSV partner_metadata_account field would include this value: {"partnerUserId":"12345abscde"}.
 

UTM Codes

Export fields: 

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Webhook event fields: 

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Information: 

If a user navigates to a TurboVote URL that includes UTM (Urchin Tracking Module) code query parameters like utm_source, utm_medium, utm_campaign, utm_content, and utm_term (e.g. https://{partner-hostname}.turbovote.org/?lang=en&utm_source=newsletter&utm_medium=social&utm_campaign=springfling&utm_term=register&utm_content=banner-ad) and signs-up using any TurboVote tool, the query parameters values are associated with resulting TurboVote user account profile.

A UTM code (Urchin Tracking Module code) is a snippet of text added to a URL that helps marketers track the source, medium, and campaign of website traffic, revealing which marketing efforts are most effective, with key parameters like utm_source, utm_medium, utm_campaign, utm_content, and utm_term to categorize traffic data in analytics tools like Google Analytics.
 

TurboVote Tool Attribution: Signup App

Export field: signup_app 

Webhook event field: signedUpVia

Information: This field indicates which tool’s sign-up flow resulted in creation of a TurboVote account.

Values:

  • turbovote - The user signed up through TurboVote’s Registration Assistance flow (e.g. {partner}.turbovote.org/register-to-vote/voter-info).
  • check-your-reg - The user signed up through the Check Your Registration tool (e.g. {partner}.turbovote.org/check-your-registration/voter-info). 
  • reminders - The user signed up through the Election Reminders tool (e.g. {partner}.turbovote.org/reminders/voter-info).
  • reminders-ballot - The user signed up through the Sample Ballot tool (e.g. {partner}.turbovote.org/whats-on-your-ballot/voter-info).

  • request-ballot - The user signed up through the Request Absentee Ballot tool (e.g. {partner}.turbovote.org/request-ballot/voter-info).

TurboVote Tool Attribution: Signup Source

Export field: signup_source 

Webhook event field: n/a

Availability: This field is only accessible via the TurboVote Bulk Export API.

Information: This field indicates whether the account was imported by a partner to TurboVote.

Values:

  • true - The user’s account was imported by a partner to TurboVote.
  • null or false - The user’s account was created when the user used one of the sign-up flows detailed in the signup_app field.
     

Voting Method Preference

Export field: voting_method_preference

Information: This field indicates how the user prefers to vote. 

Values:

  • By-mail - The user indicated they plan to cast their vote by mail, or they are registered to vote in a state that runs elections by mail. As a result of this choice, TurboVote will log their preference, and provide them with the state-specific information they need to cast their ballot by mail.
    • The value is set if
      • When getting help registering to vote, the user indicated they prefer to cast their vote by mail, or live in a state that runs elections by mail. This value is also set if a user gets help from TurboVote to request a mail ballot.
    • As a result of this choice, TurboVote will log their preference, and provide them with the state-specific information they need to cast their ballot by mail.
  • In-person -The user indicated that they prefer to vote in person when getting help registering to vote. As a result of this choice, TurboVote will log their preference as an in-person voter.

     

User Engagement Insights

Timestamps

Updated At

Export field: updated_at 

Webhook event field: updatedAt

Information: This field captures the last time the user's information was updated in the TurboVote system. For most users, this will reflect the end of their signup. It is updated whenever a user adds or edits account information, engages with our help desk or chooses to unsubscribe. Timestamps are recorded in Coordinated Universal Time (UTC) and listed in chronological order. 

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2023-09-19 01:30:58

 

Returning User Last Updated At

Export field: returning_user_last_updated_at 

Webhook event field: N/A

Information: This field captures the date and time that a user last updated their account information with TurboVote via our edit account user flow. If this field is blank, the user has not yet accessed the returning user flow. Timestamps are recorded in Coordinated Universal Time (UTC) and listed in chronological order. 

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2023-09-19 01:30:58

 

User Engagement Actions

The following fields display the most up-to-date information available about actions users have taken related to voter registration and registration applications.

 

Latest Voter Registration Status

Export field: latest_registration_status_tool

Webhook event field: tool

Information: This field indicates which application the user checked their registration status with. Currently, this field only returns one value, turbovote.

In the future, TurboVote may integrate with other tools - including official election administration tools - at which point, this field will be used to reference those tools.

Value example: Currently only returns a single value: turbovote

 

Latest Voter Registration Status Source

Export field: latest_registration_status_source

Webhook event field: source

Information: This field shows the source of a user’s voter registration status details. 

Currently, our Check Your Registration tool checks if the user is registered to vote by searching the TargetSmart Voter Registration Service database of registered voter records. This service is relied upon by numerous voting and elections organizations, as a vast majority of states do not provide direct programmatic access to their voter registration rolls.

In the future, TurboVote may integrate with other services - including official election administration databases - at which point this field will be used to reference those sources.

Value example: Currently only returns a single value: targetsmart-api

 

Latest Voter Registration Status Matched

Export field: latest_registration_status_matched

Webhook event field: matched

Information: This field shows the results of TargetSmart Voter Registration Service database of registered voters query.

Values: 

  • TRUE if result matches a single voter file record, user is deemed registered to vote, and the following fields are returned: registrationStatus, voterStatus, voterbaseId
  • FALSE if result matches zero or more than two voter file records

     

Latest Voter Registration Status

Export field: latest_registration_status_registration_status

Webhook event field: registrationStatus

Information: This field indicates the status of a user’s voter registration application (optional).

Value: Only returns a single value: registered

 

Latest Voter Status

Export field: latest_registration_status_voter_status

Webhook event field: voterStatus

Information: This field indicates whether a voter is considered active or inactive by the Secretary of State or State Board of Elections.. Not every state includes this field in voter file records (optional).

Values: 

  • active
  • inactive
  • unknown

Latest Voter File Update

Export field: latest_registration_status_voter_file_update_date

Webhook event field: voterFileUpdateDate

Information: This field shows the date a user’s voter file is received by TargetSmart from the state. This information is the most recent registration date on the file.

Value format: YYYY-MM-DD

Example: 2024-07-30

 

Latest Voter Registration Application Status

When a user gets help registering to vote from TurboVote, we track what application method they choose to pursue (if there are more than one in their state) as well as the status of their engagement with our registration assistance tool.

This event does not report the status of a voter’s application directly with the state or local election official.

 

Latest Voter Registration Application Method

Export field: latest_registration_application_method

Webhook event field: applicationMethod

Information: This field indicates the voter registration method the user selected in TurboVote. Values depend on a user’s state and its voter registration application options and regulations.

Values: 

  • by-mail - the user indicated in TurboVote they will submit a voter registration application by mail.
  • online - the user indicated in TurboVote they will submit a voter registration application online. 
  • call-clerk - the user indicated in TurboVote they will contact their election office directly to submit a voter registration application because they reside in a state (e.g. New Hampshire) that requires voters to contact their election official directly to register to vote.
  • not-applicable - the user indicated in TurboVote that they plan to vote in North Dakota, which does not have voter registration.


Latest Voter Registration Application Status

Export field: latest_registration_application_status

Webhook event field: applicationStatus

Information: This field indicates the status of the user’s voter registration application. Values depend on a user’s state and its voter registration application options and regulations.

Values: 

  • form-generated - The user generated a National Mail Voter Registration Form on TurboVote OR the user started, but did not complete, the voter registration flow on TurboVote and no form was generated.
  • completed - After getting help from TurboVote to register to vote online, the user either
    •  returned to TurboVote and answered “Yes” to the question “Did you finish the online voter registration process?“
    • tapped the “Yes, I Registered Online” button in a registration assistance follow-up notification
  • incomplete - After getting help from TurboVote to register to vote online, the user either
    • returned to TurboVote and answered “No” to the question “Did you finish the online voter registration process?“
    • tapped the “No, Help Finish Registration” button in a registration assistance follow-up notification
  • Initiated - The user started, but did not complete, the registration application assistance flow on TurboVote and did not confirm that they completed their state’s online voter registration application.
  • not-required - A user living in New Hampshire attempted to use TurboVote to get help registering to vote but were advised to contact their local election official to register to vote OR a user living in North Dakota attempted to use TurboVote to get help registering to vote but were advised that North Dakota does not register voters.
  • Ineligible - User indicated that they are not a citizen of the United States. No National Mail Voter Registration Form was generated


Latest Voter Registration Application Source

Export field: latest_registration_application_status_source

Webhook Event Field: applicationSource

Information: This field shows how applicationStatus was determined.

Values: 

  • turbovote - applicationStatus was determined by TurboVote data about user flow completion
  • user - applicationStatus was determined by user’s answer to a specific question in TurboVote
     

Latest Voter Registration Application Status Source Medium

Export field: latest_registration_application_status_source_medium

Webhook Event Field: applicationStatusSourceMedium

Information: This field shares what user experience a user engaged with when taking an action that updated their applicationStatus.

Values: 

  • web - The user engaged with the TurboVote website personalized for their TurboVote account.
  • email - The user engaged with a Registration Assistance Follow-up Email Notification (i.e. a personalized TurboVote Registration Assistance url with m=e query parameter appended) 
  • sms - The user engaged with a Registration Assistance Follow-up SMS Notification (i.e. a personalized TurboVote Registration Assistance url with m=m query parameter appended)

 

Latest Voter Registration Application Time

Export field: latest_registration_application_method_time

Webhook event field: time

Information: This field shows the time a voter registration application event was emitted.

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2023-09-19 01:30:58

 

Latest Registration Application Form Generated Details

These three fields provide details about the voter registration form generated by TurboVote when a user opts to register to vote by mail using a paper form.

Registration Application Form URL

Export field: latest_registration_application_form_url

Webhook event field: applicationFormURL

Information: This field returns a url to the voter registration form generated by TurboVote when a user opts to register to vote by mail using a paper form. Url is valid for 30 days.

Value format: URL

Example: https://f-staging.tvote.org/d37HTjk2QziNe-Aw3bkAPA

Registration Application Form Type

Export field: latest_registration_application_form_type

Webhook event field: applicationFormType

Information: This field indicates whether the voter registration form generated by TurboVote is the National Voter Registration Form or a state-specific form (when required). 

Value format: string

Values: 

  • default - National Voter Registration Form
  • Two-letter State abbreviation e.g. wy for Wyoming
Registration Application Form Prefilled?

Export field: latest_registration_application_form_prefilled

Webhook event field: applicationFormPrefilled

Information: This boolean field indicates whether the voter registration form generated by TurboVote is prefilled with a user’s profile details and responses to registration fields (in some states). 

Value format: boolean

Values: 

  • true - voter registration form generated by TurboVote is prefilled with a user’s profile details and responses to registration fields (in some states)
  • false - voter registration form generated by TurboVote is NOT prefilled with a user’s profile details to comply with state regulations prohibiting third parties from prefilling voter registration forms

Registration Application Form Local Election Office Details

These three fields provide name, physical and mailing address of the local election office users must return the voter registration form generated by TurboVote.

Registration Application Local Election Office Name

Export field: latest_registration_application_local_office_name

Webhook event field: applicationLocalOfficeName

Information: This field returns the name of the the local election office users must return the voter registration form generated by TurboVote.

Value format: string

Example: "Fremont County"

Registration Application Local Election Office Physical Address

Export field: latest_registration_application_local_contact_physical_address

Webhook event field: applicationLocalOfficePhysicalAddress

Information: This field returns the physical address of the local election office users must return the voter registration form generated by TurboVote.

Value format: string

Example: "450 N 2ND ST RM 220, LANDER, WY, 82520-0090"

Registration Application Local Election Office Mailing Address

Export field: latest_registration_application_local_contact_mailing_address

Webhook event field: applicationLocalOfficeMailingAddress

Information: This field returns the mailing address of the local election office users must return the voter registration form generated by TurboVote.

Value format: string

Example: "450 N 2ND ST RM 220, LANDER, WY, 82520-0090"

 

Latest Ballot Request

Latest Ballot Request Method  

Export field: latest_ballot_request_method

Webhook event field: action: method

Information: This field indicates how the user requested a mail ballot.

Value example: Values include: 

  • null - The user visited their state’s Mail Ballot Request guide (on initial sign-up or on subsequent personalized visits) but failed to take action requesting a mail ballot.
  • request-online - The user visited a state’s election website to request a mail ballot online.
  • request-by-mail - The user visited a state’s election website to download a mail ballot request form.
  • request-from-election-office - The user visited a state’s election website to access local election office contact information in order to request a ballot
  • check-registration-status - The user lives in a state that automatically sends them a ballot in the mail ahead of each election and visited the state's election website to check what address is associated with their voter record to ensure their ballot will be sent to the right address.
  • send-ballot-to-different-address - The user lives in a state that automatically sends them a ballot in the mail ahead of each election and visited the state's election website to have their ballot sent to a different address.

Latest Ballot Request Status  

Export field: latest_ballot_request_status

Webhook event field: action: status

Information: This field indicates the status of the user’s attempt to request a mail ballot.

Value example: Values include: 

  • initiated - The user submitted the Mail Ballot Request form or tapped a personalized Request Mail Ballot hyperlink but took no further action.
  • accessed-state-site - The user accessed their state website.
  • downloaded-form - The user visited a state’s election website to download a mail ballot request form.
  • completed - The user indicated that they completed their mail ballot request action (generally by tapping the “Yes” button in Request Ballot Follow-up Notification (i.e. a personalized TurboVote Mail Ballot Request url with rb=y query parameter appended) 
  • incomplete - The user indicated that they completed their mail ballot request action (generally by tapping the “No” button in Request Ballot Follow-up Notification (i.e. a personalized TurboVote Mail Ballot Request url with rb=n query parameter appended) 

Latest Ballot Request Source  

Export field: latest_ballot_request_source

Webhook event field: action: source

Information: This field indicates how TurboVote determined the user took this action.

Value example: Values include: 

  • user - The user tapped a link or button
    • submitted the Request Ballot sign-up form
    • tapped 
      • a link or button on a personalized TurboVote page
      • a personalized hyperlink (likely in a notification)
  • turbovote - Not returned in current version of the TurboVote Mail Ballot Request Tool

Latest Ballot Request Medium  

Export field: latest_ballot_request_medium

Webhook event field: action: medium

Information: This field indicates which TurboVote experience the user engaged with to take this action.

Value example: Values include: 

  • web - The user engaged with the TurboVote website personalized for their TurboVote account.
  • email - The user engaged with a Request Ballot Follow-up Email Notification (i.e. a personalized TurboVote Mail Ballot Request url with m=e query parameter appended) 
  • sms - The user engaged with a Request Ballot Follow-up SMS Notification (i.e. a personalized TurboVote Mail Ballot Request url with m=m query parameter appended)

Latest Voter Ballot Request Time

Export field: latest_ballot_request_time

Webhook event field: time

Information: This field shows the time a ballot request event was emitted.

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2025-09-19 01:30:58

 

Latest Election Action Taken

We track when an existing user visits a personalized election guide (generally the link in an election reminder) and takes a key action to make a plan to vote.

Note: These fields are only accessible via the TurboVote Bulk Export API.

 

Time Action Taken

Export field: latest-election-action-time

Webhook event field: time

Information: This field indicates when an existing user either visited a personalized election guide or clicked a key action on a personalized election guide.

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2024-09-30T14:37:08.839-00:00

 

Election Details

The following fields describe the election the user took action on, including the election’s date, description, Open Civic Data Identifier and district type.:

Election Date

Export field: latest_election_action_election_date

Webhook event field: date

Information: This field indicates the date of the election.

Value: YYYY-MM-DD

Example: 2024-11-04

 

Election Description

Export field: latest_election_action_election_description

Webhook event field: description

Information: This field indicates the description of the election

Value: string

Example: California General Election

 

Election Open Civic Data Identifier

Export field: latest_election_action_election_ocdid

Webhook event field: ocdId

Information: This field indicates the Open Civic Data Identifier (OCD-ID) of the election.

Value: string

Example: ocd-division/country:us/state:ca

 

Election District Type

Export field: latest_election_action_election_type

Webhook event field: type

Information: This field indicates the district type of the election.

Value: enum: "congressional" "county" "municipal" "presidentialPrimary" "school" "state" "stateHouse" "stateSenate" "subMunicipal"

 

Election Action Details

Action Type

Export field: latest_election_action_type

Webhook event field: type

Information: This field indicates what action the user took on the TurboVote election guide from just visiting the page to interacting with key components. Timestamps are recorded in Coordinated Universal Time (UTC).

Value: 

  • User visited a personalized TurboVote election guide
    • visited-guide - The user visited their personalized TurboVote election guide web page
  • User indicated that they've already voted in a specific election
    • i-voted - user indicated that they've already voted in a specific election when they
    • i-voted-tapped-by-mistake - user indicated that they mistakenly indicated that they already voted in a specific election by
      • tapping "I Haven’t Voted Yet" on a personalized election guide in Already Voted mode
    • i-voted-in-person-early - user indicated that they cast their ballot in person before election day
    • i-voted-by-mail-usps - user indicated that they cast their ballot by returning it in the mail
    • i-voted-by-mail-dropoff - user indicated that they cast their ballot by returning it to election officials
    • i-voted-in-person-election-day - user indicated that they cast their ballot in person on election day
       
  • After visiting an election guide, user took key actions on the guide:
    • Visited state's election administration website to get and stay registered
      • accessed-state-registration-lookup - The user visited their personalized TurboVote election guide web page and accessed their state’s voter registration status lookup tool
      • accessed-state-online-registration-application-site - The user visited their personalized TurboVote election guide web page and accessed their state’s voter online registration application tool
      • accessed-state-bymail-registration-application-site - The user visited their personalized TurboVote election guide web page and accessed their state website to learn how to register to vote by mail
      • accessed-state-election-day-registration-application-site - The user visited their personalized TurboVote election guide web page and accessed their state’s voter registration website to learn how to register to vote on election day
    • Visited state's election administration website to vote by mail
      • requested-ballot - The user visited their personalized TurboVote election guide web page and accessed their state’s website to request a mail ballot
      • tracked-ballot - The user visited their personalized TurboVote election guide web page and accessed their state’s website to track their mail ballot
      • Accessed-state-site-fix-ballot - The user visited their personalized TurboVote election guide web page and accessed their state’s website to fix or cure their mail ballot.
         
    • Researched what's on their ballot
      • viewed-ballot - The user visited the TurboVote election guide web page and accessed their personalized TurboVote ballot guide
      • viewed-ballot-office - The user visited their personalized TurboVote ballot guide and viewed the list of candidates for a specific office on their ballot
      • viewed-ballot-candidate - The user visited their personalized TurboVote ballot guide and viewed a specific candidate running for a specific office on their ballot
      • viewed-ballot-measures - The user visited their personalized TurboVote ballot guide and viewed a list of all ballot measures on their ballot
      • viewed-ballot-measure - The user visited their personalized TurboVote ballot guide and viewed a specific ballot measures on their ballot
         
    • Engaged with personalized sample ballot
      • added-sample-ballot - The user visited their personalized TurboVote ballot guide (i.e. sample ballot) and selected or ranked at least one candidate or selected at least one ballot measure stance (i.e. yes or no)
      • emailed-sample-ballot - The user emailed themselves a link to their personalized TurboVote ballot guide (i.e. sample ballot)
      • printed-sample-ballot - The user printed their personalized TurboVote ballot guide (i.e. sample ballot)
      • copied-sample-ballot - The user copied a link to their personalized TurboVote ballot guide (i.e. sample ballot)
         
    • Found where to vote
      • searched-where-to-vote-drop-off-location - The user visited their personalized TurboVote election guide web page and accessed their state’s website to find where to drop off their mail ballot
      • searched-where-to-vote-early - The user visited their personalized TurboVote election guide web page and accessed their state’s website to find where to vote in person in advance of election day
      • searched-where-to-vote-on-election-day - The user visited their personalized TurboVote election guide web page and accessed their state’s website to find where to vote on election day
      • searched-where-to-vote-votinginfotool - The user visited their personalized TurboVote election guide web page and searched where to vote in person (on election or early) or drop off their mail ballot using the Voting Information Project’s Voting Information Tool.
    • Shared election guide
      • shared-election-guide-by-email - The user visited the TurboVote election guide web page and tapped a link to share the guide via email
      • shared-election-guide-by-sms - The user visited the TurboVote election guide web page and tapped a link to share the guide via text message
      • shared-election-guide-copied-link - The user visited the TurboVote election guide web page and tapped a link to copy the URL to their device’s clipboard
    • Accessed Election Results
      • viewed-election-results-ap - The user visited their personalized TurboVote election guide web page and accessed The Associated Press website to view election results
      • viewed-election-results - The user visited their personalized TurboVote election guide web page and viewed election results on their TurboVote ballot guide 
Action Description

Export field: latest_election_action_description

Webhook event field: description

Information: This field describes the action the user took. 

  • If the user visited an election guide, the description will include the date and description of the election. 
  • If the user visited an election guide and took a key action, the description will generally be the label of the button or link tapped by the user.

Value: string

Example: 

  • User visited TurboVote Election Guide: “Nov 5 2024 California General Election TurboVote Election Guide”
  • User visited TurboVote Election Guide and tapped button to access their state’s online registration tool: “Register Online by Oct 7”

 

Action URL

Export field: latest_election_action_url

Webhook event field: url

Information: This field indicates the url of the action taken. 

  • If the user visited an election guide, this field shares the election guide’s url. 
  • If the user visited an election guide and took a key action, this field shares the target url of the button or link tapped by the user.

Value: string

Example:

  • User visited TurboVote Election Guide: “https://example.turbovote.org/elections/ca/2024-11-05”
  • User visited TurboVote Election Guide and tapped button to access their state’s online registration tool: “https://registertovote.ca.gov/?t=s”
Action Source

Export field: latest_election_action_source

Webhook event field: source

Information: This field indicates how TurboVote determined that action was taken. On launch, all actions reported are those of the user interacting with TurboVote election guides.

Value: string

Example: user

Action Page Type

Export field: latest_election_action_page_type

Webhook event field: page: type

Information:This field indicates the type of TurboVote election guide page where the user took the key action.

Value:

  • election: TurboVote Voting Guide Guide for a given election
  • ballot: TurboVote Ballot Guide for a given election
  • ballot-office: TurboVote Guide for a specific office on the ballot for a given election
  • ballot-candidate: TurboVote Guide for a specific candidate running for an office on the ballot for a given election
  • ballot-measures: TurboVote Guide listing all measures on the ballot for a given election
  • ballot-measure: TurboVote Guide for a specific measures on the ballot for a given election
     

Example: user

Action Referrer Type

Export field: latest_election_action_referrer_type

Webhook event field: referrer: type

Information: This field indicates how the user discovered the TurboVote election guide

Value: 

  • personalizedUrl - The user visited a personalized TurboVote election guide url directly.
  • upcoming-election-reminder - The user tapped the personalized TurboVote election guide url in their TurboVote Upcoming Election Reminder.
  • vote-asap-reminder - The user tapped the personalized TurboVote election guide url in their TurboVote Vote ASAP Reminder.
  • vote-tomorrow-reminder - The user tapped the personalized TurboVote election guide url in their TurboVote Vote Tomorrow Reminder.
Action Referrer Medium

Export field: latest_election_action_referrer_medium

Webhook event field: referrer: medium

Information: This field indicates the medium how the user discovered the TurboVote election guide

Value: 

  • link - The user visited a personalized TurboVote election guide url directly.
  • email - The user tapped the personalized TurboVote election guide url in a TurboVote election reminder email
  • sms - The user tapped the personalized TurboVote election guide url in a TurboVote election reminder SMS

 

Legacy Fields

The following legacy fields now have corresponding expanded fields to provide our partners with more precise, timely, and useful information about users’ registration and voting status. 

While these legacy fields provided general information about user actions on TurboVote, the expanded fields offer more granular detail about user interactions with TurboVote, plus users’ TargetSmart Voterbase ID and, when available, records from state governments. This provides higher quality insights on actions voters have taken in relation to registering and voting. 

If you are looking for information from a legacy field, refer to the corresponding expanded field(s) if available. If you have any questions about using these new fields, reach out to developers@turbovote.org.

 

Voter Registration Status

Previous export field: voter_registration_status

Replaced by group of expanded fields: Latest Voter Registration Status:

  • latest_registration_status_tool
  • latest_registration_status_matched
  • latest_registration_status_registration_status
  • latest_registration_status_voter_status  

Voter Registration Source

Previous export field: voter_registration_source

Replaced by: latest_registration_status_source

 

Voter Registration Method

Previous export field: voter_registration_method

Replaced by: latest_registration_application_method

Youth User Accounts

Individual-level data related to TurboVote’s preregister to vote has a separate set of fields. Partners can export user account data via the Admin Console. 

We include field names for User Export and Webhooks as available. Read on for a description of each data field. 

 

Youth User Account Profile

Name

Legal Name

Export field: first_name, middle_name, last_name

Information: This field shows a user’s legal name.

Value: First name, middle name, last name

Example: David Samuel Cortez

Preferred Name

Export field: preferred_name

Information: This field shows a user’s preferred name. Within TurboVote, users must provide their legal first name, but they also have the option to provide a nickname. This preferred name is used in all TurboVote-generated experiences instead of the first name. If a user provides a nickname during signup, the preferred name column is populated with that name. Otherwise, it is populated with the user’s provided legal first name. 

Value example: Sammy 

 

Contact Information

Contact Methods

Export fields: phone, email

Information: During the signup process, users are required to enter both a phone number and email. Partners can use the contact information provided to send follow-up campaigns to their TurboVote users, alerting them of upcoming deadlines, campus-specific events, etc.

Value examples: 888-090-4447, dscortez1113@gmail.com

 

Partner Communications Checkbox

Export fields: partner_comms_opt_in

Information: The partner communications checkbox can be added to your TurboVote communications preferences page. It gives users the option to check a box according to the custom language next to the checkbox. To add this feature to your site, please submit the customizations request form.

Values: If TRUE, this field indicates that a user says “yes” to the custom language. FALSE and a blank cell both indicate that the user has not opted-in to the custom language.

 

Address

State

Export field: state

Information: This field shares the two letter abbreviation of the state in which the user currently resides.

Value example: NY

 

Address

Export fields: address_street, address_street-2, address_city, address_state, address_zip

Information: These fields share the user’s current address.

Value example: 20 Jay Street, Suite 410, Brooklyn NY, 11201

 

Birthdates

Date of Birth

Export field:  birthdate

Information: This field allows partners to track the age range of their users. Users who sign up with TurboVote input their full date of birth during the signup process.

Value: YYYY-MM-DD

Example: 2007-01-31

 

Language Preference

Export field: language_preference

Information: This field indicates whether TurboVote uses English or Spanish when interacting with the user.

Values: en or es

 

Identifiers

I.D.

Export field: id

Information: Unique identifying number for each user primarily used by the TurboVote system. These strings of letters, numbers, and symbols can be helpful for reporting individual user questions back to TurboVote or for discussing users in an anonymized/privacy-preserving way. For the most part, you are unlikely to use the data in this field.

 

Account Creation

Created At

Export field: created_at 

Information: This field captures the date and time TurboVote created a record for the user (i.e. when they provided TurboVote their name and contact information in the first couple steps). This can be useful for determining which times of the year experience the most successful implementation. Timestamps are recorded in Coordinated Universal Time (UTC) and listed in chronological order. 

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2024-08-01 03:45:22

 

Partner Hostname

Export field: hostname

Information: This field shows the URL through which the user signed up. 

Value: [partner].turbovote.org

Example: myfaithvotes.turbovote.org

 

Referral Code

Export field: referral_code 

Information: Referral links are useful for tracking the effectiveness of different forms of outreach. This field captures the unique referral code through which the user signed up. If the field is blank, the user came through the standard partner URL, not one with a referral code. For more information on how to create and track referral codes, contact partnerships@democracy.works.

 

Embed Placement Code 

Export field: embed_placement

Information: Leveraged by partners integrating TurboVote Embeds into various pages of their website, this field captures the code partners can assign to a specific embed placement on their website (e.g. homepage, check-registration-page).

Value example: tv-hub
 

 

UTM Codes

Export fields: 

  • utm_source
  • utm_medium
  • utm_campaign
  • utm_term
  • utm_content

Information: 

If a user navigates to a TurboVote URL that includes UTM (Urchin Tracking Module) code query parameters like utm_source, utm_medium, utm_campaign, utm_content, and utm_term (e.g. https://{partner-hostname}.turbovote.org/?lang=en&utm_source=newsletter&utm_medium=social&utm_campaign=springfling&utm_term=register&utm_content=banner-ad) and signs-up using any TurboVote tool, the query parameters values are associated with resulting TurboVote user account profile.

A UTM code (Urchin Tracking Module code) is a snippet of text added to a URL that helps marketers track the source, medium, and campaign of website traffic, revealing which marketing efforts are most effective, with key parameters like utm_source, utm_medium, utm_campaign, utm_content, and utm_term to categorize traffic data in analytics tools like Google Analytics.

 

Timestamps

Updated At

Export field: updated_at 

Information: This field captures the last time the user's information was updated in the TurboVote system. For most users, this will reflect the end of their signup. It might also be more recent based on their later interactions with TurboVote—through our help desk, returning user flow, or unsubscribe links. Timestamps are recorded in Coordinated Universal Time (UTC) and listed in chronological order. 

Value format: yyyy-MM-dd'T'HH:mm:ssZ

Example: 2023-09-19 01:30:58