---
updatedAt: 2026-05-14T14:12:27.000Z
agentTools:
  projectIndex: https://api-docs.thedatatrust.com/llms.txt
---

# VoterFile

Returns comprehensive voter profiles for the specified state, including demographics, political geography, party scores, and contact information.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Data Trust API",
    "description": "",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.thedatatrust.com/dev",
      "description": "Development"
    },
    {
      "url": "https://api.thedatatrust.com",
      "description": "Production"
    }
  ],
  "paths": {
    "/api/VoterFile": {
      "get": {
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "summary": "VoterFile",
        "description": "Returns comprehensive voter profiles for the specified state, including demographics, political geography, party scores, and contact information.",
        "operationId": "getVoters",
        "parameters": [
          {
            "$ref": "#/components/parameters/columns"
          },
          {
            "$ref": "#/components/parameters/lastUpdated"
          },
          {
            "$ref": "#/components/parameters/state"
          },
          {
            "$ref": "#/components/parameters/top"
          },
          {
            "$ref": "#/components/parameters/skip"
          },
          {
            "$ref": "#/components/parameters/rnc_RegID"
          },
          {
            "$ref": "#/components/parameters/stateVoterId"
          },
          {
            "$ref": "#/components/parameters/jurisdictionVoterId"
          },
          {
            "$ref": "#/components/parameters/countyName"
          },
          {
            "$ref": "#/components/parameters/firstName"
          },
          {
            "$ref": "#/components/parameters/lastName"
          },
          {
            "$ref": "#/components/parameters/streetAddress"
          },
          {
            "$ref": "#/components/parameters/city"
          },
          {
            "$ref": "#/components/parameters/zipCode"
          },
          {
            "$ref": "#/components/parameters/regLatitude"
          },
          {
            "$ref": "#/components/parameters/regLongitude"
          },
          {
            "$ref": "#/components/parameters/regGeoCodeLevel"
          },
          {
            "$ref": "#/components/parameters/congressionalDistrict"
          },
          {
            "$ref": "#/components/parameters/stateLegUpperDistrict"
          },
          {
            "$ref": "#/components/parameters/stateLegLowerDistrict"
          },
          {
            "$ref": "#/components/parameters/cell"
          },
          {
            "$ref": "#/components/parameters/landline"
          },
          {
            "$ref": "#/components/parameters/registeredParty"
          },
          {
            "$ref": "#/components/parameters/ageRange"
          },
          {
            "$ref": "#/components/parameters/sex"
          }
        ],
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VoterFileResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "parameters": {
      "columns": {
        "name": "columns",
        "in": "query",
        "description": "A comma separated list of columns to return. Leave blank to return all",
        "schema": {
          "type": "string"
        }
      },
      "state": {
        "name": "state",
        "in": "query",
        "description": "Two character state abbreviation, eg. VA, DC",
        "required": true,
        "schema": {
          "type": "string"
        }
      },
      "lastUpdated": {
        "name": "lastUpdated",
        "in": "query",
        "description": "Get data updated after Datetime. Provide Dates and Times in ISO 8601 format.",
        "schema": {
          "type": "string"
        }
      },
      "top": {
        "name": "top",
        "in": "query",
        "description": "Get the top x results",
        "schema": {
          "type": "integer"
        }
      },
      "skip": {
        "name": "skip",
        "in": "query",
        "description": "skip the first x results",
        "schema": {
          "type": "integer"
        }
      },
      "rnc_RegID": {
        "name": "rnc_RegID",
        "in": "query",
        "description": "Get records by reg id",
        "schema": {
          "type": "string"
        }
      },
      "congressionalDistrict": {
        "name": "congressionalDistrict",
        "in": "query",
        "description": "get data by congressional district",
        "schema": {
          "type": "integer"
        }
      },
      "firstName": {
        "name": "firstName",
        "in": "query",
        "description": "get data by first name",
        "schema": {
          "type": "string"
        }
      },
      "lastName": {
        "name": "lastName",
        "in": "query",
        "description": "get data by last name",
        "schema": {
          "type": "string"
        }
      },
      "streetAddress": {
        "name": "streetAddress",
        "in": "query",
        "description": "get data by Registration Street Address",
        "schema": {
          "type": "string"
        }
      },
      "city": {
        "name": "city",
        "in": "query",
        "description": "get data by Registration Address City",
        "schema": {
          "type": "string"
        }
      },
      "zipCode": {
        "name": "zipCode",
        "in": "query",
        "description": "get data by Registration Address Zip Code",
        "schema": {
          "type": "string"
        }
      },
      "regLatitude": {
        "name": "regLatitude",
        "in": "query",
        "description": "get data by Registration Address Latitude",
        "schema": {
          "type": "string"
        }
      },
      "regLongitude": {
        "name": "regLongitude",
        "in": "query",
        "description": "get data by Registration Address Longitude",
        "schema": {
          "type": "string"
        }
      },
      "regGeoCodeLevel": {
        "name": "regGeoCodeLevel",
        "in": "query",
        "description": "get data by Registration Address Geocode Level",
        "schema": {
          "type": "string"
        }
      },
      "stateLegUpperDistrict": {
        "name": "stateLegUpperDistrict",
        "in": "query",
        "description": "get data by State Legislative Upper District",
        "schema": {
          "type": "string"
        }
      },
      "stateLegLowerDistrict": {
        "name": "stateLegLowerDistrict",
        "in": "query",
        "description": "get data by State Legislative Lower District",
        "schema": {
          "type": "string"
        }
      },
      "countyName": {
        "name": "countyName",
        "in": "query",
        "description": "get data by County Name",
        "schema": {
          "type": "string"
        }
      },
      "stateVoterId": {
        "name": "stateVoterId",
        "in": "query",
        "description": "get data by State Voter ID",
        "schema": {
          "type": "string"
        }
      },
      "jurisdictionVoterId": {
        "name": "jurisdictionVoterId",
        "in": "query",
        "description": "get data by Jurisdiction Voter ID",
        "schema": {
          "type": "string"
        }
      },
      "cell": {
        "name": "cell",
        "in": "query",
        "description": "get data by cell phone number",
        "schema": {
          "type": "string"
        }
      },
      "landline": {
        "name": "landline",
        "in": "query",
        "description": "get data by landline phone number",
        "schema": {
          "type": "string"
        }
      },
      "registeredParty": {
        "name": "registeredParty",
        "in": "query",
        "description": "Filter by Registered Party",
        "schema": {
          "type": "string"
        }
      },
      "ageRange": {
        "name": "ageRange",
        "in": "query",
        "description": "Filter by Age Range",
        "schema": {
          "type": "string",
          "enum": [
            "17-25",
            "26-35",
            "36-45",
            "46-55",
            "56-65",
            "66-75",
            "76-Over",
            "Unknown"
          ]
        }
      },
      "sex": {
        "name": "sex",
        "in": "query",
        "description": "Filter by Sex",
        "schema": {
          "type": "string",
          "enum": [
            "F",
            "M",
            "U"
          ]
        }
      }
    },
    "schemas": {
      "VoterFileResponse": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "RNCID": {
              "type": "integer"
            },
            "RNC_Regid": {
              "type": "string"
            },
            "Prev_RNCID": {
              "type": "integer"
            },
            "State": {
              "type": "string"
            },
            "Statekey": {
              "type": "integer"
            },
            "IsPartyReg": {
              "type": "integer"
            },
            "SourceID": {
              "type": "string"
            },
            "Juriscode": {
              "type": "string"
            },
            "Jurisname": {
              "type": "string"
            },
            "CountyFIPS": {
              "type": "string"
            },
            "CountyName": {
              "type": "string"
            },
            "MediaMarket": {
              "type": "string"
            },
            "CensusBlock2020": {
              "type": "string"
            },
            "MetroType": {
              "type": "string"
            },
            "MCD": {
              "type": "string"
            },
            "StateCountyCode": {
              "type": "string"
            },
            "StateTownCode": {
              "type": "string"
            },
            "Ward": {
              "type": "string"
            },
            "PrecinctCode": {
              "type": "string"
            },
            "PrecinctName": {
              "type": "string"
            },
            "BallotBox": {
              "type": "string"
            },
            "SchoolBoard": {
              "type": "string"
            },
            "SchoolDistrict": {
              "type": "string"
            },
            "CityCouncil": {
              "type": "string"
            },
            "CountyCommissioner": {
              "type": "string"
            },
            "CongressionalDistrict": {
              "type": "integer"
            },
            "CongressionalDistrict_PreviousElection": {
              "type": "integer"
            },
            "StateLegUpperDistrict": {
              "type": "integer"
            },
            "StateLegUpperDistrict_PreviousElection": {
              "type": "integer"
            },
            "StateLegUpperDistrict_Proper": {
              "type": "string"
            },
            "StateLegUpperDistrict_Proper_PreviousElection": {
              "type": "string"
            },
            "StateLegLowerDistrict": {
              "type": "integer"
            },
            "StateLegLowerDistrict_PreviousElection": {
              "type": "integer"
            },
            "StateLegLowerSubDistrict": {
              "type": "string"
            },
            "StateLegLowerSubDistrict_PreviousElection": {
              "type": "string"
            },
            "StateLegLowerDistrict_Proper": {
              "type": "string"
            },
            "StateLegLowerDistrict_Proper_PreviousElection": {
              "type": "string"
            },
            "NamePrefix": {
              "type": "string"
            },
            "FirstName": {
              "type": "string"
            },
            "MiddleName": {
              "type": "string"
            },
            "LastName": {
              "type": "string"
            },
            "NameSuffix": {
              "type": "string"
            },
            "Sex": {
              "type": "string"
            },
            "BirthYear": {
              "type": "string"
            },
            "BirthMonth": {
              "type": "string"
            },
            "BirthDay": {
              "type": "string"
            },
            "Age": {
              "type": "integer"
            },
            "AgeRange": {
              "type": "string"
            },
            "CongressionalAgeRange": {
              "type": "string"
            },
            "RegisteredParty": {
              "type": "string"
            },
            "PartyRollUp": {
              "type": "string"
            },
            "CalcParty": {
              "type": "integer"
            },
            "ModeledParty": {
              "type": "integer"
            },
            "StateVoterID": {
              "type": "string"
            },
            "JurisdictionVoterID": {
              "type": "string"
            },
            "LastActivityDate": {
              "type": "string"
            },
            "RegistrationDate": {
              "type": "string"
            },
            "RegistrationDateSource": {
              "type": "string"
            },
            "VoterStatus": {
              "type": "string"
            },
            "PermanentAbsentee": {
              "type": "string"
            },
            "EthnicityReported": {
              "type": "string"
            },
            "EthnicityModeled": {
              "type": "string"
            },
            "EthnicGroupModeled": {
              "type": "string"
            },
            "EthnicGroupNameModeled": {
              "type": "string"
            },
            "ReligionModeled": {
              "type": "string"
            },
            "LanguageModeled": {
              "type": "string"
            },
            "ACSEthnicity_White": {
              "type": "number"
            },
            "ACSEthnicity_Black": {
              "type": "number"
            },
            "ACSEthnicity_Hispanic": {
              "type": "number"
            },
            "ACSEthnicity_Asian": {
              "type": "number"
            },
            "ACSEthnicity_Other": {
              "type": "number"
            },
            "ACSEducation_HighSchool": {
              "type": "number"
            },
            "ACSEducation_College": {
              "type": "number"
            },
            "ACSEducation_Graduate": {
              "type": "number"
            },
            "ACSEducation_Vocational": {
              "type": "number"
            },
            "ACSEducation_None": {
              "type": "number"
            },
            "HouseHoldID": {
              "type": "integer"
            },
            "HouseHoldMemberID": {
              "type": "integer"
            },
            "HouseHoldParty": {
              "type": "string"
            },
            "RegistrationAddr1": {
              "type": "string"
            },
            "RegistrationAddr2": {
              "type": "string"
            },
            "RegHouseNum": {
              "type": "string"
            },
            "RegHouseSfx": {
              "type": "string"
            },
            "RegStPrefix": {
              "type": "string"
            },
            "RegStName": {
              "type": "string"
            },
            "RegStType": {
              "type": "string"
            },
            "RegstPost": {
              "type": "string"
            },
            "RegUnitType": {
              "type": "string"
            },
            "RegUnitNumber": {
              "type": "string"
            },
            "RegCity": {
              "type": "string"
            },
            "RegSta": {
              "type": "string"
            },
            "RegZip5": {
              "type": "string"
            },
            "RegZip4": {
              "type": "string"
            },
            "RegLatitude": {
              "type": "string"
            },
            "RegLongitude": {
              "type": "string"
            },
            "RegGeocodeLevel": {
              "type": "string"
            },
            "RegLastCleanse": {
              "type": "string",
              "format": "date-time"
            },
            "RegLastGeoCode": {
              "type": "string",
              "format": "date-time"
            },
            "RegLastCOA": {
              "type": "string",
              "format": "date-time"
            },
            "ChangeOfAddressSource": {
              "type": "string"
            },
            "ChangeOfAddressDate": {
              "type": "string"
            },
            "ChangeOfAddressType": {
              "type": "string"
            },
            "MailingAddr1": {
              "type": "string"
            },
            "MailingAddr2": {
              "type": "string"
            },
            "MailHouseNum": {
              "type": "string"
            },
            "MailHouseSfx": {
              "type": "string"
            },
            "MailStPrefix": {
              "type": "string"
            },
            "MailStName": {
              "type": "string"
            },
            "MailStType": {
              "type": "string"
            },
            "MailStPost": {
              "type": "string"
            },
            "MailUnitType": {
              "type": "string"
            },
            "MailUnitNumber": {
              "type": "string"
            },
            "MailCity": {
              "type": "string"
            },
            "MailSta": {
              "type": "string"
            },
            "MailZip5": {
              "type": "string"
            },
            "MailZip4": {
              "type": "string"
            },
            "MailSortCodeRoute": {
              "type": "string"
            },
            "MailDeliveryPt": {
              "type": "string"
            },
            "MailDeliveryPtChkDigit": {
              "type": "string"
            },
            "MailLineOfTravel": {
              "type": "string"
            },
            "MailLineOfTravelOrder": {
              "type": "string"
            },
            "MailDPVStatus": {
              "type": "string"
            },
            "MailLastCleanse": {
              "type": "string",
              "format": "date-time"
            },
            "MailLastCOA": {
              "type": "string",
              "format": "date-time"
            },
            "Cell": {
              "type": "string"
            },
            "CellSourceCode": {
              "type": "string"
            },
            "CellMatchLevel": {
              "type": "string"
            },
            "CellReliabilityCode": {
              "type": "string"
            },
            "CellFTCDoNotCall": {
              "type": "string"
            },
            "CellAppendDate": {
              "type": "string",
              "format": "date-time"
            },
            "CellDataAxle": {
              "type": "string"
            },
            "CellDataAxleMatchLevel": {
              "type": "string"
            },
            "CellDataAxleReliabilityCode": {
              "type": "string"
            },
            "CellDataAxleFTCDoNotCall": {
              "type": "string"
            },
            "CellDataAxleAppendDate": {
              "type": "string",
              "format": "date-time"
            },
            "CellRawVF": {
              "type": "string"
            },
            "CellRawVF_FirstObserved": {
              "type": "string",
              "format": "date-time"
            },
            "CellABEV": {
              "type": "string"
            },
            "CellABEV_FirstObserved": {
              "type": "string",
              "format": "date-time"
            },
            "CellNeustar": {
              "type": "string"
            },
            "CellNeustarMatchLevel": {
              "type": "string"
            },
            "CellNeustarReliabilityCode": {
              "type": "string"
            },
            "CellNeustarTimeOfDay": {
              "type": "string"
            },
            "CellNeustarAppendDate": {
              "type": "string"
            },
            "Landline": {
              "type": "string"
            },
            "LandlineSourceCode": {
              "type": "string"
            },
            "LandlineMatchLevel": {
              "type": "string"
            },
            "LandlineReliabilityCode": {
              "type": "string"
            },
            "LandlineFTCDoNotCall": {
              "type": "string"
            },
            "LandlineAppendDate": {
              "type": "string",
              "format": "date-time"
            },
            "LandlineDataAxle": {
              "type": "string"
            },
            "LandlineDataAxleMatchLevel": {
              "type": "string"
            },
            "LandlineDataAxleReliabilityCode": {
              "type": "string"
            },
            "LandlineDataAxleFTCDoNotCall": {
              "type": "string"
            },
            "LandlineDataAxleAppendDate": {
              "type": "string",
              "format": "date-time"
            },
            "LandlineRawVF": {
              "type": "string"
            },
            "LandlineRawVF_FirstObserved": {
              "type": "string",
              "format": "date-time"
            },
            "LandlineABEV": {
              "type": "string"
            },
            "LandlineABEV_FirstObserved": {
              "type": "string",
              "format": "date-time"
            },
            "LandlineNeustar": {
              "type": "string"
            },
            "LandlineNeustarMatchLevel": {
              "type": "string"
            },
            "LandlineNeustarReliabilityCode": {
              "type": "string"
            },
            "LandlineNeustarTimeOfDay": {
              "type": "string"
            },
            "LandlineNeustarAppendDate": {
              "type": "string",
              "format": "date-time"
            },
            "VoterFrequencyGeneral": {
              "type": "integer"
            },
            "VoterFrequencyPrimary": {
              "type": "integer"
            },
            "VoterRegularityGeneral": {
              "type": "number"
            },
            "VoterRegularityPrimary": {
              "type": "number"
            },
            "PreviousState": {
              "type": "string"
            },
            "PreviousState_RegID": {
              "type": "string"
            },
            "PreviousRegParty": {
              "type": "string"
            },
            "FirstObservedState": {
              "type": "string"
            },
            "FirstObservedState_RegID": {
              "type": "string"
            },
            "FirstObservedDate": {
              "type": "string",
              "format": "date-time"
            },
            "MatchedMoveState": {
              "type": "string"
            },
            "MatchedMoveState_RegID": {
              "type": "string"
            },
            "DonorFlag": {
              "type": "string"
            },
            "MostRecentVote_State": {
              "type": "string"
            },
            "MostRecentVote_Method": {
              "type": "string"
            },
            "MostRecentVote_DTE": {
              "type": "integer"
            },
            "VH26G": {
              "type": "string"
            },
            "VH26P": {
              "type": "string"
            },
            "VH25G": {
              "type": "string"
            },
            "VH25P": {
              "type": "string"
            },
            "VH24G": {
              "type": "string"
            },
            "VH24P": {
              "type": "string"
            },
            "VH24PP": {
              "type": "string"
            },
            "VH23G": {
              "type": "string"
            },
            "VH23P": {
              "type": "string"
            },
            "VH22G": {
              "type": "string"
            },
            "VH22P": {
              "type": "string"
            },
            "VH21G": {
              "type": "string"
            },
            "VH21P": {
              "type": "string"
            },
            "VH20G": {
              "type": "string"
            },
            "VH20P": {
              "type": "string"
            },
            "VH20PP": {
              "type": "string"
            },
            "VH19G": {
              "type": "string"
            },
            "VH19P": {
              "type": "string"
            },
            "VH18G": {
              "type": "string"
            },
            "VH18P": {
              "type": "string"
            },
            "VH17G": {
              "type": "string"
            },
            "VH17P": {
              "type": "string"
            },
            "VH16G": {
              "type": "string"
            },
            "VH16P": {
              "type": "string"
            },
            "VH16PP": {
              "type": "string"
            },
            "VH15G": {
              "type": "string"
            },
            "VH15P": {
              "type": "string"
            },
            "VH14G": {
              "type": "string"
            },
            "VH14P": {
              "type": "string"
            },
            "VH13G": {
              "type": "string"
            },
            "VH13P": {
              "type": "string"
            },
            "VH12G": {
              "type": "string"
            },
            "VH12P": {
              "type": "string"
            },
            "VH12PP": {
              "type": "string"
            },
            "VH11G": {
              "type": "string"
            },
            "VH11P": {
              "type": "string"
            },
            "VH10G": {
              "type": "string"
            },
            "VH10P": {
              "type": "string"
            },
            "VH09G": {
              "type": "string"
            },
            "VH09P": {
              "type": "string"
            },
            "VH08G": {
              "type": "string"
            },
            "VH08P": {
              "type": "string"
            },
            "VH08PP": {
              "type": "string"
            },
            "VH07G": {
              "type": "string"
            },
            "VH07P": {
              "type": "string"
            },
            "VH06G": {
              "type": "string"
            },
            "VH06P": {
              "type": "string"
            },
            "PER24Pres_GOP": {
              "type": "number"
            },
            "PER24Pres_DEM": {
              "type": "number"
            },
            "PER24Pres_OTH": {
              "type": "number"
            },
            "CoalitionID_SocialConservative": {
              "type": "string"
            },
            "CoalitionID_Veteran": {
              "type": "string"
            },
            "CoalitionID_Sportsmen": {
              "type": "string"
            },
            "CoalitionID_2ndAmendment": {
              "type": "string"
            },
            "CoalitionID_ProLife": {
              "type": "string"
            },
            "CoalitionID_ProChoice": {
              "type": "string"
            },
            "CoalitionID_FiscalConservative": {
              "type": "string"
            },
            "RepublicanPartyScore": {
              "type": "number"
            },
            "DemocraticPartyScore": {
              "type": "number"
            },
            "RepublicanBallotScore": {
              "type": "number"
            },
            "DemocraticBallotScore": {
              "type": "number"
            },
            "TurnoutGeneralScore": {
              "type": "number"
            },
            "HouseholdIncomeModeled": {
              "type": "string"
            },
            "EducationModeled": {
              "type": "string"
            },
            "Custom01": {
              "type": "string"
            },
            "Custom02": {
              "type": "string"
            },
            "Custom03": {
              "type": "string"
            },
            "Custom04": {
              "type": "string"
            },
            "Custom05": {
              "type": "string"
            },
            "LastUpdate": {
              "type": "string",
              "format": "date-time"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "jwt"
      }
    }
  }
}
```