📌 Note: Features are available in our Political bundle. For more information on adding new features please see the add-ons page in your nation.

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

Download a sample voter record

Did this answer your question?