Table of Contents
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: Permanently 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
Sample voter record