National Voter File Fields

The following fields are provided in a voter file export and follow the following formats


Individual Information

States supply information on each voter's name and, at their discretion, the voter's age, registration date, language, phone, email, and other individual info. They also indicate, at their discretion, which voters are registered for alternative voting methods like absentee and permanent absentee ballots.

Field Name Description Field Type
state_file_id

ID for each voter, unique within their state.
See state_file_id documentation for details.

String
county_file_id ID for each voter, unique within their county.
Does not exist in many states.
String
prefix Name prefix (Mr., Mrs., Dr., etc) Propercased String
first_name   Propercased String
middle_name   Propercased String
last_name   Propercased String
suffix Name suffix (Esq., I, IV, etc) Propercased String
Preserve Roman Numerals
demo Demographics field, not provided by some states. 1-Character String
birthdate Date of birth, not provided by some states yyyy-mm-dd
sex Male, Female, Other, or blank if not provided M/F/O
language See NationBuilder language documentation. 2-5-Character String
email Voter email address, not provided by most states. Lowercased String
email_opt_in All voter records are automatically set to 'False' so
that they cannot be included in email blasts from
a NationBuilder nation.
FALSE
phone Phone number as provided by state 10 digit integer
no punctuation or spaces
federal_donotcall Indicates if the voter is on a federal do-not-call list.
Not provided by most states
T/F Case Insensitive
is_absentee_voter Voter is signed up to receive absentee ballots T/F Case Insensitive
is_active_voter Voter is considered active by their state T/F Case Insensitive
is_early_voter Signed up to receive early-vote ballots T/F Case Insensitive
is_permanent_absentee_voter Permanentely receives absentee ballots T/F Case Insensitive
party Indicates party affiliation, not provided by all states.
See party documentation
Full Party Name
registered_at Indicates when the voter registered to vote.
May change if they move counties and re-register.
yyyy-mm-dd

Contact Information

States supply, at their discretion, every registered voter's registration address and mailing address.

Field Name Description Field Type
registered_address__address1 Registered street address Propercased String
Maintain Punctuation
registered_address__address2 Registered unit address Propercased String
Maintain Punctuation
registered_address__address3 Registered unit address Propercased String
Maintain Punctuation
registered_address__city Registered city Propercased String
Maintain Punctuation
registered_address__zip Registered zip Propercased String
Maintain Punctuation
format: Zip5-Zip4
registered_address__state Registered state Uppercased State Abbreviation
registered_address__county Registered county Propercased String
Maintain Punctuation
registered_address__fips Registered fips
(derived by NationBuilder
not supplied by the state)
5-Digit Integer
registered_address__country_code Registered country, always "US" 2-Digit ISO Country Code
mailing_address__address1 Mailing street address Propercased String; Maintain Punctuation
mailing_address__address2 Mailing unit address Propercased String; Maintain Punctuation
mailing_address__address3 Mailing unit address Propercased String; Maintain Punctuation
mailing_address__city Mailing city Propercased String; Maintain Punctuation
mailing_address__zip Mailing zip String; Maintain Punctuation, format: Zip5-Zip4
mailing_address__state Mailing state Uppercased State Abbreviation
mailing_address__county Mailing county Propercased String Maintain; Punctuation
mailing_address__fips Mailing fips 5-Digit Integer
mailing_address__country_code Mailing country 2-Digit ISO Country Code

District Information

Many local political districts, especially below the county level, are unique state-by-state. Each state decides how much of a registered voter's full district data will be made available in the statewide voter file. Every voter at least has their federal and statewide districts, with county commission and city government districts also normally (but not always) included.

Field Name Description Field Type
federal_district Congressional district Integer
state_upper_district State Senate or Unicameral Integer
state_lower_district State House Integer
judicial_district State Judicial district.
Not provided by some states
Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
county_district County Commission district.
Not provided by some states
Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
fire_district

Fire Safety district

Not provided by many states

Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
village_district

Village/Super-local municipal district

Not provided by many states

Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
city_district City/Municipal district Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
city_sub_district Sub-municipal district Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
school_district School Board district.
Not provided by some states
Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
school_sub_district Local board district.
Not provided by many states
Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
nbec_precinct_code NationBuilder Election Center precinct code.
NationBuilder generates this value
It is a unique geographical ID for
each precinct in the state,
and shows the county and city
that precinct is within.
Uppercased String
Join Columns with "-"
Normalize White Space with "_"
Remove Area Titles
Normalize Punctuation with Underscores
(not existing dashes or underscores)
Import as Nbec_Precinct Nbec_Code

If you’re unclear on how this feature works, please ask a question. If you would like to see changes to this feature, please submit a suggestion.