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.
Brokers Fields
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.
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 property the person represents as a broker. Links directly to a key within our property data.
Example:
"propertiesRepresented": ["us/ut/ogden/668w4150s"]
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
Contact Fields
A list of emails associated with this person.
Example:
"emails": ["doug@idronline.net"]
The personal email addresses of the person.
Example:
"personalEmails": ["mesheldo@gmail.com"]
The highest reachable score (how likely the person is to pick up the phone) of the most recent landline phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreLand": "+1 440-238-1444"
The highest reachable score (how likely the person is to pick up the phone) amount of a landline phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreLandScore": 100
The highest reachable score (how likely the person is to pick up the phone) of the most recent mobile phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreMobile": "+1 602-571-8454"
The highest score amount (how likely the person is to pick up the phone) of the most recent mobile phone from the phoneNumbers field.
Example:
"phoneNumberHighScoreMobileScore": 90
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 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"]
Core Identity Fields
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"
The date of death of the person.
Example:
"dateOfDeath": "2020-07-27T00:00:00Z"
The value to determine if the person is currently deseased.
Example:
"deceased": true
The person's first name.
Example:
"firstName": "Doug"
The person's gender.
Example:
"gender": "male"
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"
Generic Fields
The date this person was first added to the people database.
Example:
"dateAdded": "2017-01-08T19:12:13Z"
The most recent date this person was updated or seen by our system.
Example:
"dateUpdated": "2017-01-08T19:12:13Z"
The personal interests of the person.
Example:
"interests": ["disaster and humanitarian relief", "politics", "human rights", "cooking", "startups"]
A flag indicating whether the person is on the TCPA litigators list.
Example:
"tcpa": false
Geographical Fields
The current work address of this person.
Example:
"address": "1125 Lancaster Avenue"
The current city where this person works.
Example:
"city": "Berwyn"
The current country where this person works.
Example:
"country": "US"
The current postal/zip code where this person works.
Example:
"postalCode": "19312-1243"
The current province/state where this person works.
Example:
"province": "PA"
Professional & Employment Fields
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"
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 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"
LinkedIn URL for this person. LinkedIn
Example:
"linkedinURL": "https://linkedin.com/in/some-person-7525231"
The maximum number of employees at the business where this person currently works.
Example:
"numEmployeesMax": 99
The minimum number of employees at the business where this person currently works.
Example:
"numEmployeesMin": 20
Property & Asset Fields
The purchase date of the most recent property in relation to this person.
Example:
"mostRecentPropertyPurchaseDate": "2024-12-04T00:00:00.000Z"
The most recent matching property key to the Datafiniti property database. Typically the currently owned property in regards to this person.
Example:
"mostRecentPropertyPurchaseKey": "us/az/phoenix/3327n18thave"
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 generated key from Datafiniti's property data. This key directly links a property to the person. Whether that be the broker or the owner of the property itself.
Example:
"propertyKeys": ["us/tx/sugarland/72grantslkcir"]
Source Fields
A list of each unique domain found in the sourceURLs field.
Example:
"domains": ["datafiniti.co"]
The URL of the person's most recent professional profile picture.
Example:
"mostRecentProfileImageURL": "https://storage.googleapis.com/upnest1/upload/realtor/1532839254_3e19998c-d18b-4d98-b4d6-a468c70e0e6c.jpeg"
The person's professional profile picture URLs.
Example:
"profileImageURLs": "https://storage.googleapis.com/upnest1/upload/realtor/1532839254_3e19998c-d18b-4d98-b4d6-a468c70e0e6c.jpeg"
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"]
Last updated 2 weeks ago
Built with Documentation.AI