> For the complete documentation index, see [llms.txt](https://docs.datafiniti.co/llms.txt). > Use it to discover all available pages before exploring further. # 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 The number of active property listings currently associated with the broker. **Example:** ```json "currentListingCount": 5 ``` A list of licenses associated with this person. **Example:** ```json "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 listing price among the broker's active property listings. **Example:** ```json "maxListingPrice": 895000 ``` The maximum most recently sold price of a property from the broker. **Example:** ```json "maxRecentSoldPrice": 700000 ``` The minimum listing price among the broker's active property listings. **Example:** ```json "minListingPrice": 69000 ``` The minimum most recently sold price of a property from the broker. **Example:** ```json "minRecentSoldPrice": 155000 ``` The property the person represents as a broker. Links directly to a key within our property data. **Example:** ```json "propertiesRepresented": ["us/ut/ogden/668w4150s"] ``` The number of recently sold properties associated with the broker. **Example:** ```json "recentlySoldCount": 32 ``` The total count of properties sold by the broker. **Example:** ```json "salesCountAllTime": 55 ``` The total count of properties sold by the broker within the last 365 days. **Example:** ```json "salesCountLastYear": 12 ``` The most recent date the broker's sales history was seen by Datafiniti. **Example:** ```json "salesHistoryDateSeen": "2026-09-06T16:02:39.028Z" ``` ## Contact Fields A list of emails associated with this person. **Example:** ```json "emails": ["doug@idronline.net"] ``` The personal email addresses of the person. **Example:** ```json "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:** ```json "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:** ```json "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:** ```json "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:** ```json "phoneNumberHighScoreMobileScore": 90 ``` A list of verified phone numbers where this person can be reached. **Example:** ```json { "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:** ```json "primaryEmail": "maggie.sheldon@hover.to" ``` The person's professional email addresses. **Example:** ```json "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:** ```json "birthDate": "1977-10-02" ``` The birth year of the person in `YYYY` format. **Example:** ```json "birthYear": "1977" ``` The date of death of the person. **Example:** ```json "dateOfDeath": "2020-07-27T00:00:00Z" ``` The value to determine if the person is currently deseased. **Example:** ```json "deceased": true ``` The person's first name. **Example:** ```json "firstName": "Doug" ``` The person's gender. **Example:** ```json "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](https://datafiniti.co). **Example:** ```json "keys": ["dougidronlinenet"] ``` The person's last name. **Example:** ```json "lastName": "Guyer" ``` The person's middle name or middle initial. **Example:** ```json "middleName": "A" ``` ## Generic Fields The date this person was first added to the people database. **Example:** ```json "dateAdded": "2017-01-08T19:12:13Z" ``` The most recent date this person was updated or seen by our system. **Example:** ```json "dateUpdated": "2017-01-08T19:12:13Z" ``` The personal interests of the person. **Example:** ```json "interests": ["disaster and humanitarian relief", "politics", "human rights", "cooking", "startups"] ``` ## Geographical Fields The current work address of this person. **Example:** ```json "address": "1125 Lancaster Avenue" ``` The current city where this person works. **Example:** ```json "city": "Berwyn" ``` The current country where this person works. **Example:** ```json "country": "US" ``` The current postal/zip code where this person works. **Example:** ```json "postalCode": "19312-1243" ``` The current province/state where this person works. **Example:** ```json "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](/docs/possible-values-for-people-fields). **Example:** ```json "businessCategories": ["Advertising Agencies"] ``` The current business where this person works. **Example:** ```json "businessName": "International Direct Response Inc" ``` A list of the person's employment experiences. Each experience contains: **Example:** ```json "experiences": [ { "jobTitle": "commercial mortgage underwriting intern", "jobLevel": "training", "businessName": "principal financial group", "numEmployeesMin": 10001, "numEmployeesMax": 10001, "address": "711 high street", "city": "des moines", "province": "iowa", "country": "united states", "latitude": "41.60,-93.60", "websites": ["principal.com"], "companyFounded": "1879" } ] ``` The street address of the business for this experience. The name of the business for this experience. The city of the business for this experience. The year the business was founded. The country of the business for this experience. The job level held in this experience. The job title held in this experience. The latitude and longitude coordinates of the business, as a comma-separated string. The maximum number of employees at the business for this experience. The minimum number of employees at the business for this experience. The province/state of the business for this experience. A list of websites associated with the business for this experience. A list of category keywords used for previous businesses in the person's experience. Industries for people data can be found [here](/docs/possible-values-for-people-fields). **Example:** ```json "industries": ["Advertising Agencies"] ``` The person's current job function. Job function values can be found [here](/docs/possible-values-for-people-fields). **Example:** ```json "jobFunction": "Marketing" ``` The person's current job level. Job level values can be found [here](/docs/possible-values-for-people-fields). **Example:** ```json "jobLevel": "C-Team" ``` The person's job-related skills. **Example:** ```json "jobSkills": ["enterprise software", "start ups", "monetization", "product management", "agile methodologies"] ``` The person's current job title. **Example:** ```json "jobTitle": "President of New Business Development" ``` LinkedIn URL for this person. [LinkedIn](https://www.linkedin.com/) **Example:** ```json "linkedinURL": "https://linkedin.com/in/some-person-7525231" ``` The maximum number of employees at the business where this person currently works. **Example:** ```json "numEmployeesMax": 99 ``` The minimum number of employees at the business where this person currently works. **Example:** ```json "numEmployeesMin": 20 ``` A flag indicating whether the person is on the TCPA litigators list. **Example:** ```json "tcpa": false ``` ## Property & Asset Fields The purchase date of the most recent property in relation to this person. **Example:** ```json "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:** ```json "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:** ```json "propertiesOwned": ["us/or/sisters/68885hurtleyrnchrd"] ``` A list of properties owned by this person with purchase and sale dates. **Example:** ```json [ { "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 date the homeowner purchased the property. The date the property owner sold this property. The property data record that corresponds to the homeowner. 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:** ```json "propertyKeys": ["us/tx/sugarland/72grantslkcir"] ``` ## Source Fields A list of each unique domain found in the `sourceURLs` field. **Example:** ```json "domains": ["datafiniti.co"] ``` The URL of the person's most recent professional profile picture. **Example:** ```json "mostRecentProfileImageURL": "https://storage.googleapis.com/upnest1/upload/realtor/1532839254_3e19998c-d18b-4d98-b4d6-a468c70e0e6c.jpeg" ``` The person's professional profile picture URLs. **Example:** ```json "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:** ```json "sourceURLs": ["https://datafiniti.co"] ``` A list of websites associated with this person. **Example:** ```json "websites": ["https://www.homes.com/real-estate-agents/chris-whitten/gdlvldw/", "https://www.premeerrealestate.com/"] ```