Person Schema

A breakdown of the person-related fields we offer

Overview

This page lists all fields within our Person Dataset. We have broken these out into the following sections:

For access to fields beyond the Base Person Fields, please speak to one of our data consultants.

Base Person Fields

📘

Formatting Notes

The dot notation indicates that the property exist one level within a hash. If a field is not present within a record, then we’ll return an empty list or a null value for that field.

FIELD NAMEFIELD TYPEPersistence Commitments and FormatSHORT DESCRIPTIONEXAMPLE
idStringThe PDL persistent ID.qEnOZ5Oh0poWnQ1luFBfVw_0000
full_nameStringFree text fieldThe first and the last name fields appended with a space.sean thorne
first_nameStringFree text fieldThe person's first name.sean
middle_initialStringFree text field, single characterThe person's middle initial.f
middle_nameStringFree text fieldThe person's middle name.fong
last_initialStringFree text field, single characterThe first letter of the person's last name.t
last_nameStringFree text fieldThe person's last name.thorne
genderStringCanonical GendersThe person's gender.male
birth_yearDate*Date string in the format of YYYY-MM-DD. It is represented as an Int for Data License customers (see October 2021 Release Notes (v16)).The approximated birth date associated with this person profile. If a profile has a birth_date, the birth_year field will match it.1990
birth_dateDateDate string in the format of YYYY-MM-DD. It can be accurate to the day (YYYY-MM-DD), the month (YYYY-MM) or the year (YYYY.) If this field exists, birth_year will agree with it.The birth date associated with this person profile.1990-12-03
linkedin_urlStringURL of the form linkedin.com/in/<linkedin_username> and not necessarily an active profile.The main LinkedIn profile URL for this record based on source agreement.linkedin.com/in/seanthorne
linkedin_usernameStringFree text field with blacklisted valuesThe main LinkedIn username for this record based on source agreement.seanthorne
linkedin_idStringThe main LinkedIn profile ID for this record based on source agreement.145991517
facebook_urlStringURL of the form facebook.com/<facebook_username>The Facebook profile URL.facebook.com/deseanthorne
facebook_usernameStringThe Facebook username.deseanthorne
facebook_idStringThe persistent Facebook ID associated with the person's Facebook profile.1089351304
twitter_urlStringThe Twitter URL.twitter.com/seanthorne5
twitter_usernameStringThe Twitter username.seanthorne5
github_urlStringURL of the form github.com/<github_username>The main GitHub profile for this record based on source agreement.github.com/deseanathan_thornolotheu
github_usernameStringThe main GitHub profile username for this record based on source agreement.deseanathan_thornolotheu
work_emailStringValid email address formattingThe current professional email.[email protected]
personal_emailsArray (String)The list of all emails tagged as type = personal.["[email protected]", "[email protected]"]
mobile_phoneStringThe highly confident direct-dial mobile phone associated with this person.17095944554
industryEnum (String)The most relevant industry for this record based primarily on their tagged personal industries and secondarily on the industries of the companies that they have worked for.computer software
job_titleStringThe person's current job title.co-founder and chief executive officer
job_title_roleEnum (String)Canonical Job RolesThe derived role of the person's current job title.operations
job_title_sub_roleEnum (String)Canonical Job Sub RolesThe derived subrole of the person's current job title. Each subrole maps to a role.logistics
job_title_levelsArray (Enum (String))Canonical Job Title LevelsThe derived levels of the person's current job title.["cxo", "owner"]
job_company_idStringThe person's current company's PDL ID.peopledatalabs
job_company_nameStringThe person's current company's name.people data labs
job_company_websiteStringThe person's current company's website.peopledatalabs.com
job_company_sizeEnum (String)Canonical Company SizesThe person's current company's size range.51-200
job_company_foundedDate*Date string in the format of YYYY-MM-DD. It is represented as an Int for Data License customers (see October 2021 Release Notes (v16).)The person's current company's foundation date.2015
job_company_industryEnum (String)Canonical IndustriesThe person's current company's industry.computer software
job_company_linkedin_urlStringThe person's current company's LinkedIn URL.linkedin.com/company/peopledatalabs
job_company_linkedin_idStringThe person's current company's LinkedIn ID.1640694639
job_company_facebook_urlStringThe person's current company's Facebook URL.facebook.com/peopledatalabs
job_company_twitter_urlStringThe person's current company's Twitter URL.twitter.com/peopledatalabs
job_company_location_nameStringThe canonical location of the person's current company's headquarters.san francisco, california, united states
job_company_location_localityStringThe locality of the person's current company's headquarters.san francisco
job_company_location_metroEnum (String)Canonical MetrosThe metro area of the person's current company's headquarters.san francisco, california
job_company_location_regionStringThe region of the person's current company's headquarters.california
job_company_location_geoStringThe geolocation coordinates of the person's current company's headquarters.37.77,-122.41
job_company_location_street_addressStringThe street address of the person's current company's headquarters.455 Market Street Suite 1690
job_company_location_address_line_2StringThe address line 2 of the person's current company's headquarters.suite 1690
job_company_location_postal_codeStringThe postal code of the person's current company's headquarters.94105
job_company_location_countryEnum (String)Canonical CountriesThe country of the person's current company's headquarters.united states
job_company_location_continentEnum (String)Canonical ContinentsThe continent of the person's current company's headquarters.north america
job_last_updatedDateDate string in the format of YYYY-MM-DDThe timestamp that a new data source contributed to this record for the person's current job, which indicated either new information or validation of existing information.2018-11-05
job_start_dateDateDate string in the format of YYYY-MM-DDA date that indicates the start period of the object, which can be accurate to the day (YYYY-MM-DD), the month (YYYY-MM) or the year (YYYY).2015-03
location_nameStringThe current canonical location of the person.berkeley, california, united states
location_localityStringThe current locality of the person.berkeley
location_metroEnum (String)Canonical MetrosThe current MSA of the person.san francisco, california
location_regionStringThe current region of the person.california
location_countryEnum (String)Canonical CountriesThe current country of the person.united states
location_continentEnum (String)Canonical ContinentsThe current continent of the person.north america
location_street_addressStringThe current street address of the person.455 fake st
location_address_line_2StringThe current address line 2 of the person.apartment 12
location_postal_codeStringThe current postal code of the person.94704
location_geoStringThe current geolocation coordinates of the person.37.87,-122.27
location_last_updatedDateDate string in the format of YYYY-MM-DDThe timestamp that a new data source contributed to this record for the current location, which indicates either new information or validation of existing information.2018-11-05
phone_numbersArray (String)The phone numbers associated with this person profile in E164 format.17095944554
emailsArray (Object)The emails associated with this person profile.
emails.addressStringThe fully-parsed email address.[email protected]
emails.typeEnum (String)The type of email, either current_professional, professional, personal or null.professional
interestsArray (String)The interests associated with the profile.
skillsArray (String)The skills associated with the profile.
location_namesArray (String)The list of all canonical location names associated with the person.["berkeley, california, united states", "san francisco, california, united states"]
regionsArray (String)The list of regions associated with the person.["california, united states"]
countriesArray (Enum (String))Canonical CountriesThe list of countries associated with the person.["united states"]
street_addressesArray (Object)The list of fully-parsed addresses associated with the person.
street_addresses.street_addressStringThe street address associated with the location object.455 fake st
street_addresses.address_line_2StringThe secondary street address associated with the location object.apartment 12
street_addresses.nameStringA string that appends location fields together to create a standard location field.berkeley, california, united states
street_addresses.localityStringThe administrative locality associated with the location object.berkeley
street_addresses.metroEnum (String)Canonical MetrosThe metro area associated with the location object.san francisco, california
street_addresses.regionStringThe administrative region associated with the location object.california
street_addresses.postal_codeStringThe postal code associated with the location object.94704
street_addresses.countryStringThe country associated with the location object.united states
street_addresses.geoStringThe geolocation coordinates associated with the location object in [latitude, longitude] format.37.87,-122.27
street_addresses.continentEnum (String)Canonical ContinentsThe continent associated with the country in the location object.north america
experienceArray (Object)The experience objects associated with this person profile, which, when output in CSV format, have indexing based on recency and associativity.
experience.titleObjectA dictionary object that provides a canonicalized title, role and level. For raw titles, see the premium field experience.title.raw.
experience.title.nameStringThe inputted title from our data sources with some basic cleaning and mapping in order to help with merging.chief executive officer and co-founder
experience.title.levelsArray (Enum (String))Canonical Job Title LevelsThe levels associated with a title.["cxo"]
experience.title.roleEnum (String)Canonical Job RolesThe derived role of the person's job title.operations
experience.title.sub_roleEnum (String)Canonical Job Sub RolesThe derived subrole of the person's job title. Each subrole maps to a role.logistics
experience.companyObjectA dictionary of information for the associated company.
experience.company.idStringOur current (NON-PERSISTENT) ID that ties company data to the canonical data.peopledatalabs
experience.company.nameStringThe name associated with the company.people data labs
experience.company.websiteStringThe website associated with the company.peopledatalabs.com
experience.company.foundedDate*Date string in the format of YYYY-MM-DD. It is represented as an Int for Data License customers (see October 2021 Release Notes (v16)).The year that the company was founded.2015
experience.company.sizeEnum (String)Canonical Company SizesThe size range of the company.51-200
experience.company.industryEnum (String)Canonical IndustriesThe industry associated with the company.computer software
experience.company.linkedin_urlStringThe LinkedIn URL associated with the company.linkedin.com/company/peopledatalabs
experience.company.linkedin_idStringThe LinkedIn ID associated with the company.1640694639
experience.company.facebook_urlStringThe Facebook URL associated with the company.facebook.com/peopledatalabs
experience.company.twitter_urlStringThe Twitter URL associated with the company.twitter.com/peopledatalabs
experience.start_dateDateDate string in the format of YYYY-MM-DDA date that indicates the start period of the object, which can be accurate to the day (YYYY-MM-DD), the month (YYYY-MM) or the year (YYYY).2015-03
experience.end_dateDateDate string in the format of YYYY-MM-DDA date that indicates the end period of the object.2011-07
experience.location_namesArray (String)Canonical locations associated with this particular job/experience object. That is, where the person is working, which may or may not be where the company is headquartered.["san francisco, california, united states"]
experience.is_primaryBooleanA value that indicates if the experience is the primary experience object in our dataset. This experience object will exist in the job_XXX fields.TRUE
experience.company.locationObjectA dictionary of information for the associated company location.
experience.company.location.street_addressStringThe street address of the company's headquarters.455 Market Street Suite 1690
experience.company.location.address_line_2StringThe address line 2 associated with the company's headquarters.suite 1690
experience.company.location.nameStringThe canonical location name associated with the company's headquarters.san francisco, california, united states
experience.company.location.localityStringThe locality of the company's headquarters.san francisco
experience.company.location.metroEnum (String)Canonical MetrosThe metro area of the company's headquarters.san francisco, california
experience.company.location.regionStringThe region of the company's headquarters.california
experience.company.location.countryEnum (String)Canonical CountriesThe country of the company's headquarters.united states
experience.company.location.postal_codeStringThe postal code associated with the company's headquarters.94105
experience.company.location.continentEnum (String)Canonical ContinentsThe continent associated with the company's headquarters.north america
experience.company.location.geoStringThe geolocation coordinates associated with the company's headquarters.37.77,-122.41
educationArray (Object)The education objects associated with this person profile, which, when output in CSV format, have indexing based on recency and associativity.
education.degreesArray (Enum (String))Canonical Education DegreesThe list of canonical degrees associated with this education object.["bachelors", "bachelors of arts"]
education.majorsArray (Enum (String))Canonical Education MajorsThe list of majors associated with this education object.["entrepreneurship"]
education.minorsArray (Enum (String))Canonical Education MajorsThe list of minors associated with this education object.["business"]
education.schoolObjectA dictionary of information for the associated school.
education.school.idStringOur current (NON-PERSISTENT) ID that ties school data to the canonical data.a56df063-4562-4e59-bc4c-68b33c14df1e
education.school.nameStringThe name associated with the school.university of oregon
education.school.websiteStringThe website URL associated with the school, which could include subdomains.business.uoregon.edu
education.school.domainStringThe website domain associated with the school.uoregon.edu
education.school.typeEnum (String)Canonical School TypesThe type of school.post-secondary institution
education.school.linkedin_urlStringThe LinkedIn URL associated with the school.linkedin.com/school/university-of-oregon
education.school.linkedin_idStringThe LinkedIn ID associated with the school.19207
education.school.facebook_urlStringThe Facebook URL associated with the school.facebook.com/universityoforegon
education.school.twitter_urlStringThe Twitter URL associated with the school.twitter.com/uoregon
education.school.locationObjectThe location associated with the school.
education.school.location.nameStringThe canonical name of the location associated with the school.eugene, oregon, united states
education.school.location.localityStringThe locality associated with the school.eugene
education.school.location.regionStringThe region associated with the school.oregon
education.school.location.countryEnum (String)Canonical CountriesThe country associated with the school.united states
education.school.location.continentEnum (String)Canonical ContinentsThe continent associated with the school.north america
education.start_dateDateDate string in the format of YYYY-MM-DDA date that indicates the start period of the object.2008-09
education.end_dateDateDate string in the format of YYYY-MM-DDA date that indicates the end period of the object.2013-06
education.gpaFloatThe GPA associated with a given degree.2.23
profilesArray (Object)Social media profiles associated with this person profile.
profiles.urlStringThe URL of the social profile.linkedin.com/in/seanthorne
profiles.idStringThe persistent ID related to this social profile, the format of which varies by social network.145991517
profiles.networkEnum (String)Canonical Profile NetworksThe network that the social profile exists on.linkedin
profiles.usernameStringThe username associated with the social profile.seanthorne
operation_idStringA value that currently exists only in data license deliveries, which allows PDL employees to identify the timestamp and operations performed on the internal data in order to return a record in a delivery.acee3bde2e1a2cb7e75c57b80d5b7bc2d5de5b02e7ea51f91304c28df77251dc
version_statusObjectDeprecated in API responsesAn object that allows customers to track the pervious and current dataset version, any other persistent IDs that were merged into this record using improved entity resolution and the status of the record.
version_status.containsArray (String)Deprecated in API responsesThe list of IDs that have been merged into this record since the last release.["qEnOZ5Oh0poWnQ1luFBfVw_0000"]
version_status.current_versionStringDeprecated in API responsesThe current version of the data.15
version_status.previous_versionStringDeprecated in API responsesThe previous version of the data.14
version_status.statusStringDeprecated in API responses (see Canonical Version Status).A value that describes the changes made to this record between the previous release and the current one.updated
dataset_versionStringThis field currently exists in the response for Person Enrichment API onlyA value that indicates the current major or minor release number.17.1

Person Risk Attributes

📘

Formatting Notes

The dot notation indicates that the property exists one level within a hash. If a field is not present, then we’ll return an empty list or a null value for that field.

FIELD NAMEFIELD TYPEPersistence Commitments and FormatSHORT DESCRIPTIONEXAMPLE
profiles.first_seenDateDate string in the format of YYYY-MM-DDThe date that this profile was first associated with this record.2017-06-02
profiles.last_seenDateDate string in the format of YYYY-MM-DDThe date that this profile was last associated with this record.2019-07-18
profiles.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this profile with this record.17
emails.first_seenDateDate string in the format of YYYY-MM-DDThe date that this email was first associated with this record.2017-06-02
emails.last_seenDateDate string in the format of YYYY-MM-DDThe date that this email was last associated with this record.2019-07-18
emails.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this email with this record.17
phonesArray (Object)The list of the phone numbers known to be associated with this record.
phones.numberStringA phone number in E164 formatThe individual phone number associated with this record.17095944554
phones.first_seenDateDate string in the format of YYYY-MM-DDThe date that this phone number was first associated with this record.2017-06-02
phones.last_seenDateDate string in the format of YYYY-MM-DDThe date that this phone number was last associated with this record.2019-07-18
phones.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this phone number with this record.17
street_addresses.first_seenDateDate string in the format of YYYY-MM-DDThe date that this street address was first associated with this record.
street_addresses.last_seenDateDate string in the format of YYYY-MM-DDThe date that this street address was last associated with this record.
street_addresses.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this street address with this record.17
linkedin_connectionsIntegerTypically 0-500, some are the true values over 500The number of LinkedIn connections the person has.432
facebook_friendsIntegerGreater than or equal to 0The number of Facebook friends the person has.3912
name_aliasesArray (String)Any additional associated names or aliases beyond the primary one currently displayed in the name field.["andrew nichol", "r andrew nichol", "robert nichol"]
possible_emailsArray (Object)Any additional emails associated with this person record that have a lower level of confidence than the currently-displayed ones in the emails array.same as the emails array
possible_phonesArray (String)Any additional phones associated with the person record that have a lower level of confidence than the currently-displayed ones in the phone_numbers array.same as the phone_numbers array
possible_profilesArray (Object)Any additional profiles associated with the person record that have a lower level of confidence than the currently-displayed ones in the profiles array.same as the profiles array
possible_street_addressesArray (Object)Any additional street addresses associated with the person record that have a lower level of confidence than the currently-displayed ones in the street_addresses array.same as the street addresses array
possible_birth_datesArray (String)Any additional birth dates associated with the person record that have a lower level of confidence than the currently-displayed one in the birth_date field.["1991-05-26", "1992-05-26"]
possible_location_namesArray (String)Inferred potential locations where the person has lived based on phone area codes, university location and other associations.same as the location_names array
experience.first_seenDateDate string in the format of YYYY-MM-DDThe date when this professional position was first associated with this record in our data.2016-10-12
experience.last_seenDateDate string in the format of YYYY-MM-DDThe date when this professional position was last associated with this record in our data.2022-01-04
job_historyArray (Object)Any additional professional positions associated with this person record beyond the ones we currently display in the experience array. Usually these are positions that have been removed or changed on resumes.[{"company": "twisselman enterprises", "title": "food service supervisor", "first_seen": "2016-05-17"}]
job_history.first_seenDateDate string in the format of YYYY-MM-DDThe date when this professional position was first associated with this record in our data.2016-05-17
job_history.last_seenDateDate string in the format of YYYY-MM-DDThe date when this professional position was last associated with this record in our data.2020-05-30
num_recordsIntegerGreater than 0The number of unique raw records contributing to this specific PDL profile.
num_sourcesIntegerGreater than 0The number of unique sources contributing to this specific PDL profile.172
first_seenDateDate string in the format of YYYY-MM-DDThe date when this record was first created in our data.2017-06-02

Premium Resume Fields

📘

Formatting Notes

The dot notation indicates that the property exists one level within a hash. If a field is not present, then we’ll return an empty list or null value for that field.

FIELD NAMEFIELD TYPEPersistence Commitments and FormatSHORT DESCRIPTIONEXAMPLE
certificationsArray (Object)Certification objects associated with this person profile.
certifications.end_dateDateDate string in the format of YYYY-MM-DDThe expiration date of the certification.2018-03
certifications.nameStringFree Text FieldThe inputted name of the certification.machine learning certification
certifications.organizationStringFree Text FieldThe inputted organization awarding the certification.coursera
certifications.start_dateDateDate string: YYYY-MM-DDThe start date of the certification.2019-04
education.rawArray (String)Free Text FieldRaw education data that was parsed into the degrees/majors/minors fields.bachelors of arts in entrepreneurship, business minor
education.school.rawArray (String)Free Text FieldRaw school names.university of oregon
education.summaryStringFree Text Field, CasedThe user-inputted summary of education.when i was at oregon i volunteered at a local homeless shelter 3 days a week
experience.company.rawArray (String)Free Text FieldRaw company names.google -- analytics team
experience.company.tickerStringFree Text Field, capitalizedThe company ticker (only for public companies.)GOOG
experience.company.typeEnum (String)Canonical Company TypesThe company type.public
experience.summaryStringFree Text Field, CasedThe user-inputted summary of experience.worked on the "search analytics" team to understand our users better
experience.title.rawArray (String)Free Text FieldRaw titles.chief executive officer and co-founder
inferred_salaryEnum (String)Canonical Inferred Salary RangesThe inferred salary range -- contact us to learn how we infer.70,000-85,000
inferred_years_experienceIntegerA value between 0 and 100The inferred years of work experience.7
job_company_tickerStringFree Text Field, capitalizedThe current company ticker.GOOG
job_company_typeEnum (String)Canonical Company TypesThe current company type.public
job_onet_codeStringThe 8-digit O*NET code for the person’s current job title, following the 2018 SOC guidelines.”11-1011.00”
job_onet_major_groupStringThe O*NET Major Group associated with the person’s current job title.”Management Occupations”
job_onet_minor_groupStringThe O*NET Minor Group associated with the person’s current job title.“Top Executives”
job_onet_broad_occupationStringThe O*NET Broad Occupation category associated with the person’s current job title.“Chief Executives”
job_onet_specific_occupationStringThe O*NET Detailed Occupation category associated with the person’s current job title.“Chief Executives”
job_onet_specific_occupation_detailStringA more detailed job title for records where the specific occupation within O*NET's standard hierarchy isn't granular enough to accurately describe the job title. For example, the highest level of granularity for C-suite positions is Chief Executives.“Chief Technology Officer”
job_summaryStringFree Text Field, CasedThe user-inputted summary of experience.worked on the "search analytics" team to understand our users better
languagesArray (Object)The list of self-identified languages spoken.
languages.nameStringCanonical LanguagesThe name of the canonical language that the person inputted.english
languages.proficiencyEnum (Integer)Score 1-5The self-identified language proficiency score: 1 (limited) - 5 (fluent).5
linkedin_connectionsIntegerTypically 0-500, some are the true values over 500The number of LinkedIn connections.50
summaryStringFree Text Field, CasedThe self-written summary tied to the person profile (often a LinkedIn summary.)growth-hacker and digital nomad

Did this page help you?