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.
The current work address of this person.
Example:
"address": "1125 Lancaster Avenue"
The full date of birth of the person in YYYY-MM-DD format.
Example:
"birthDate": "1977-10-02"
The birth year of the person in YYYY format.
Example:
"birthYear": "1977"
A list of category keywords used for the business the person currently works in. Business Categories for people data can be found here.
Example:
"businessCategories": ["Advertising Agencies"]
The current business where this person works.
Example:
"businessName": "International Direct Response Inc"
The current city where this person works.
Example:
"city": "Berwyn"
The current country where this person works.
Example:
"country": "US"
The date this person was first added to the people database.
Example:
"dateAdded": "2017-01-08T19:12:13Z"
The date of death of the person.
Example:
"dateOfDeath": "2020-07-27T00:00:00Z"
The most recent date this person was updated or seen by our system.
Example:
"dateUpdated": "2017-01-08T19:12:13Z"
The value to determine if the person is currently deseased.
Example:
"deceased": true
A list of each unique domain found in the sourceURLs field.
Example:
"domains": ["datafiniti.co"]
A list of emails associated with this person.
Example:
"emails": ["doug@idronline.net"]
The person's first name.
Example:
"firstName": "Doug"
The person's gender.
Example:
"gender": "male"
A list of category keywords used for previous businesses in the person's experience. Industries for people data can be found here.
Example:
"industries": ["Advertising Agencies"]
The personal interests of the person.
Example:
"interests": ["disaster and humanitarian relief", "politics", "human rights", "cooking", "startups"]
The person's current job function. Job function values can be found here.
Example:
"jobFunction": "Marketing"
The person's job-related skills.
Example:
"jobSkills": ["enterprise software", "start ups", "monetization", "product management", "agile methodologies"]
The person's current job title.
Example:
"jobTitle": "President of New Business Development"
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.
Example:
"keys": ["dougidronlinenet"]
The person's last name.
Example:
"lastName": "Guyer"
A list of licenses associated with this person.
Example:
"licenses": [{"type": "TREC", "value": "123456"}]
The type of license the person value is identified by.
The string value of the license identified by the type.
LinkedIn URL for this person. LinkedIn
Example:
"linkedinURL": "https://linkedin.com/in/some-person-7525231"
The person's most recent professional profile picture on their social network.
Example:
"mostRecentProfileImageURL": "https://storage.googleapis.com/upnest1/upload/realtor/1532839254_3e19998c-d18b-4d98-b4d6-a468c70e0e6c.jpeg"
The most recent purchase date of the owner of the property.
Example:
"mostRecentPropertyPurchaseDate": "2024-12-04T00:00:00.000Z"
The most recent matching property key to the Datafiniti property database.
Example:
"mostRecentPropertyPurchaseKey": "us/az/phoenix/3327n18thave"
The maximum most recently sold price of a property from the broker.
Example:
"maxRecentSoldPrice": 700000
The minimum most recently sold price of a property from the broker.
Example:
"minRecentSoldPrice": 155000
The minimum number of employees at the business where this person currently works.
Example:
"numEmployeesMin": 20
The maximum number of employees at the business where this person currently works.
Example:
"numEmployeesMax": 99
The personal email addresses of the person.
Example:
"personalEmails": ["mesheldo@gmail.com"]
The highest scored mobile phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreMobile": "+1 602-571-8454"
The highest score amount of a mobile phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreMobileScore": 90
The highest bdscore land line phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreLand": "+1 440-238-1444"
The highest score amount of a land line phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreLandScore": 100
A list of verified phone numbers where this person can be reached.
Example:
{
"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"
}
0-100 (higher the better) score on how likely the person is to pick up the phone.
Carrier of the phone number.
Last date seen of the phone number.
The 10 digit plus country code phone number.
If the person was reachable on this phone number.
Tested status of the phone.
Land line or mobile phone.
The current postal/zip code where this person works.
Example:
"postalCode": "19312-1243"
The person's current professional email address.
Example:
"primaryEmail": "maggie.sheldon@hover.to"
The person's professional email addresses.
Example:
"professionalEmails": ["maggie.sheldon@hover.to", "msheldon@mavenlink.com"]
The person's professional profile picture on their social network.
Example:
"profileImageURLs": "https://storage.googleapis.com/upnest1/upload/realtor/1532839254_3e19998c-d18b-4d98-b4d6-a468c70e0e6c.jpeg"
The person's generated key from Datafiniti. Can be used to compare in the property search API endpoint.
Example:
"propertyKeys": ["us/tx/sugarland/72grantslkcir"]
This field shows the property keys the person is connected to in Datafiniti's property database.
Deprecated as of Jan 8th, 2026.
Example:
"propertiesOwned": ["us/or/sisters/68885hurtleyrnchrd"]
A list of properties owned by this person with purchase and sale dates.
Example:
[
{
"propertyKey": "us/az/phoenix/3327n18thave",
"datePurchased": "2024-12-04T00:00:00.000Z"
},
{
"propertyKey": "us/az/phoenix/3327n18thave",
"dateSold": "2024-12-04T00:00:00.000Z",
"datePurchased": "2024-12-04T00:00:00.000Z"
}
]
The property data record that corresponds to the homeowner.
The date the homeowner purchased the property.
The date the property owner sold this property.
The property the person represents as a broker. Links directly to a key within our property data.
Example:
"propertiesRepresented": ["us/ut/ogden/668w4150s"]
The current province/state where this person works.
Example:
"province": "PA"
The total count of properties sold by the broker.
Example:
"salesCountAllTime": 55
The total count of properties sold by the broker within the last 365 days.
Example:
"salesCountLastYear": 12
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.
Example:
"sourceURLs": ["https://datafiniti.co"]
A flag indicating whether the person is on the TCPA litigators list.
Example:
"tcpa": false
Last updated Mar 27, 2026
Built with Documentation.AI