People Data Schema

The people data schema below lists all available fields in a people record. Note that actual people records may not have every field present.

Field NameExample Value (in JSON)Description
address"address": "1125 Lancaster Avenue"The current work address of this person.
Field type: text
birthDate"birthDate": "1977-10-02" The full date of birth of the person in YYYY-MM-DD format.
Field type: date
birthYear"birthYear": "1977"The birth year of the person in YYYY format.
Field type: integer
businessCategories"businessCategories": [ "Advertising Agencies" ]A list of category keywords used for the business the person currently works in. Business Categories for people data can be found here.
Field type: text
businessName"businessName": "International Direct Response Inc"The current business where this person works.
Field type: text
city"city": "Berwyn"The current city where this person works.
Field type: text
country"country": "US"The current country where this person works.
Field type: text
dateAdded"dateAdded": "2017-01-08T19:12:13Z"The date this person was first added to the people database.
Field type: date
dateOfDeath"dateOfDeath": "2020-07-27T00:00:00Z"The date of death of the person.
Field type: date
dateUpdated"dateUpdated": "2017-01-08T19:12:13Z"The most recent date this person was updated or seen by our system.
Field type: date
deceased"deceased": trueThe value to determine if the person is currently deseased.
Field type: boolean
domains"domains": [ "datafiniti.co" ]A list of each unique domain found in the sourceURLs field.
Field type: domain
emails"emails": [ "[email protected]" ]A list of emails associated with this person.
Field type: text
firstName"firstName": "Doug"The person's first name.
Field type: text
gender"gender": "male"The person's gender.
Field type: text
industries"industries": [ "Advertising Agencies" ]A list of category keywords used for previous businesses in the person's experience. Industries for people data can be found here.
Field type: text
interests"interests": [ "disaster and humanitarian relief", "politics", "human rights", "psychology", "reddit", "cooking", "starcraft ii", "startups", "online dating", "saas", "painting", "heroes of newerth", "ventures for good" ]The personal interests of the person.
Field type: text
jobFunction"jobFunction": "Marketing"The person's current job function. Job function values can be found here.
Field type: text
jobLevel"jobLevel": "C-Team"The person's current job level.
Job level values can be found here.
Field type: text
jobSkills"jobSkills": [ "enterprise software", "start ups", "monetization", "social networking", "usability", "product management", "photoshop", "user experience", "web applications", "agile methodologies", "scrum", "video games" ]The person's job-related skills.
Field type: text
jobTitle"jobTitle": "President of New Business Development"The person's current job title.
Field type: text
keys"keys": [ "dougidronlinenet" ]A list of internal Datafiniti identifiers for people. The keys field is used to merge raw data from individual sources into the master Datafiniti record. Learn more about how this works.
Field type: keyword
lastName"lastName": "Guyer"The person's last name.
Field type: text
licenses"licenses": [ { "type": "TREC", "value": "123456" } ]type: the type of license the person value is identified by
Field type: text

value: the string value of the license identified by the type
Field type: text
linkedinURL"linkedinURL": "https://linkedin.com/in/some-person-7525231"LinkedIn URL for this person. LinkedIn
Field type: keyword
numEmployeesMin"numEmployeesMin": 20The minimum number of employees at the business where this person currently works.
Field type: integer
numEmployeesMax"numEmployeesMax": 99The maximum number of employees at the business where this person currently works.
Field type: integer
phoneNumberHighScoreMobile"phoneNumberHighScoreMobile": "+1 602-571-8454",The highest scored mobile phone from the phoneNumbers field
Field type: text
phoneNumberHighScoreMobileScore"phoneNumberHighScoreMobileScore": 90The highest score amount of a mobile phone from the phoneNumbers field.
Field type: Integer
phoneNumberHighScoreLand"phoneNumberHighScoreLand": "+1 440-238-1444"The highest bdscore land line phone from the phoneNumbers field
Field type: text
phoneNumberHighScoreLandScore"phoneNumberHighScoreLandScore": 100The highest score amount of a land line phone from the phoneNumbers field.
Field type: Integer
phoneNumbers{ "number": "+1 205-665-7871", "carrier": "BELLSOUTH TELECOMM INC DBA SOUTH CENTRAL BELL TEL", "type": "Land Line", "tested": false, "reachableStatus": false, "bdscore": 70, "lastDateSeen": "2024-04-11T18:37:01.725Z" },A list of verified phone numbers where this person can be reached

bdscore: 0-100 (higher the better) score on how likely the person is to pick up the phone.
Field type: float

carrier: carrier of the phone number.
Field type: text

lastDateSeen: last date seen of the phone number
Field type: date

number: the 10 digit plus country code phone number
Field type: text

reachableStatus: if the person was reachable on this phone number.
Field type: boolean

tested: tested status of the phone
Field type: boolean

type: land line or mobile phone
Field type: text
postalCode"postalCode": "19312-1243"The current postal/zip code where this person works.
Field type: keyword
personalEmails"personalEmails": [ "[email protected]" ]The personal email addresses of the person.
Field type: text
primaryEmail"primaryEmail": "[email protected]"The person's current professional email address.
Field type: text
professionalEmails"professionalEmails"[ "[email protected]", "[email protected]" ]The person's professional email addresses.
Field type: text
province"province": "PA"The current province/state where this person works.
Field type: text
sourceURLs"sourceURLs": [ "https://datafiniti.co" ]A list of URLs used to generate data for this business location. If https://datafiniti.co is used, then the data was sourced from our data partners.
Field type: keyword
tcpa"tcpa": falseA flag indicating whether the person is on the TCPA litigators list
Field type: Boolean