Person Schema

Breakdown of the PDL Fields

Overview

This page contains a listing of all the fields contained in the Person Dataset. Fields are broken 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 is one level deep inside 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
idStringPDL persistent IDqEnOZ5Oh0poWnQ1luFBfVw_0000
full_nameStringFree text fieldThe first and the last name fields appended with a spacesean thorne
first_nameStringFree text fieldA person's first namesean
middle_initialStringFree text field, single characterA person's middle initialf
middle_nameStringFree text fieldA person's middle namefong
last_initialStringFree text field, single characterThe first letter of a person's last namet
last_nameStringFree text fieldA person's last namethorne
genderStringCanonical GendersThe person's gendermale
birth_yearDate*Date string. YYYY-MM-DD. Represented as Int for Data License customers (see October 2021 Release Notes (v16))Approximated birth date associated with this person profile. If a profile has a birth_date, the birth_year field will match1990
birth_dateDateDate string in YYYY-mm-dd format. Can be accurate to the day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY). If this exists, birth_year will agree with thisBirth date associated with this person profile1990-12-03
linkedin_urlStringUrl of the form linkedin.com/in/<linkedin_username> -- not necessarily an active profileMain linkedin profile for this record based on source agreementlinkedin.com/in/seanthorne
linkedin_usernameStringFree text field with blacklisted valuesMain linkedin username for this record based on source agreementseanthorne
linkedin_idStringMain linkedin profile id for this record based on source agreement145991517
facebook_urlStringUrl of the form facebook.com/<facebook_username>facebook profilefacebook.com/deseanthorne
facebook_usernameStringfacebook usernamedeseanthorne
facebook_idStringpersistent facebook id associated with a person's facebook profile1089351304
twitter_urlStringTwitter URLtwitter.com/seanthorne5
twitter_usernameStringTwitter Usernameseanthorne5
github_urlStringUrl of the form github.com/<github_username>Main github profile for this record based on source agreementgithub.com/deseanathan_thornolotheu
github_usernameStringMain github profile username for this record based on source agreementdeseanathan_thornolotheu
work_emailStringValid email address formattingCurrent Professional email[email protected]
personal_emailsArray (String)List of all emails tagged as type = personal["[email protected]", "[email protected]"]
mobile_phoneStringHighly confident direct dial mobile phone associated with this person17095944554
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 forcomputer software
job_titleStringA person's current job titleco-founder and chief executive officer
job_title_roleEnum (String)Canonical Job RolesA person's current job title derived roleoperations
job_title_sub_roleEnum (String)Canonical Job Sub RolesA person's job title derived subrole. Each subrole maps to a rolelogistics
job_title_levelsArray (Enum (String))Canonical Job Title LevelsA person's current job title derived levels["cxo", "owner"]
job_company_idStringA person's current company's PDL IDpeopledatalabs
job_company_nameStringA person's current company's namepeople data labs
job_company_websiteStringA person's current company's websitepeopledatalabs.com
job_company_sizeEnum (String)Canonical Company SizesA person's current company's size range51-200
job_company_foundedDate*Date string. YYYY-MM-DD. Represented as Int for Data License customers (see October 2021 Release Notes (v16))A person's current company's founded date1911
job_company_industryEnum (String)Canonical IndustriesA person's current company's industrycomputer software
job_company_linkedin_urlStringA person's current company's linkedin urllinkedin.com/company/peopledatalabs
job_company_linkedin_idStringA person's current company's linkedin id1640694639
job_company_facebook_urlStringA person's current company's facebook urlfacebook.com/peopledatalabs
job_company_twitter_urlStringA person's current company's twitter urltwitter.com/peopledatalabs
job_company_location_nameStringA person's current company's HQ canonical locationsan francisco, california, united states
job_company_location_localityStringA person's current company's HQ localitysan francisco
job_company_location_metroEnum (String)Canonical MetrosA person's current company's HQ metro areasan francisco, california
job_company_location_regionStringA person's current company's HQ regioncalifornia
job_company_location_geoStringA person's current company's HQ geo37.77,-122.41
job_company_location_street_addressStringA person's current company's HQ street_address455 Market Street Suite 1690
job_company_location_address_line_2StringA person's current company's HQ address line 2suite 1690
job_company_location_postal_codeStringA person's current company's HQ postal code94105
job_company_location_countryEnum (String)Canonical CountriesA person's current company's HQ countryunited states
job_company_location_continentEnum (String)Canonical ContinentsA person's current company's HQ continentnorth america
job_last_updatedDateDate string. YYYY-MM-DDThe timestamp a new data source contributed to this record for the current job indicating either new information or validation of existing information2018-11-05
job_start_dateDateDate string. YYYY-MM-DDIndicates the start period of the object. Can be accurate to the day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY)2015-03
location_nameStringthe current canonical location of the personberkeley, california, united states
location_localityStringthe current locality of the personberkeley
location_metroEnum (String)Canonical Metrosthe current MSA of the personsan francisco, california
location_regionStringthe current region of the personcalifornia
location_countryEnum (String)Canonical Countriesthe current country of the personunited states
location_continentEnum (String)Canonical Continentsthe current continent of the personnorth america
location_street_addressStringthe current street address of the person455 fake st
location_address_line_2Stringthe current address line 2 of the personapartment 12
location_postal_codeStringthe current postal code of the person94704
location_geoStringthe current geo of the person37.87,-122.27
location_last_updatedDateDate string. YYYY-MM-DDThe timestamp a new data source contributed to this record for the current location indicating either new information or validation of existing information2018-11-05
phone_numbersArray (String)Phone numbers associated with this person profile in E164 format17095944554
emailsArray (Object)Emails associated with this person profile.
emails.addressStringThe full parsed email[email protected]
emails.typeEnum (String)The type of email either current_professional, professional, personal or nullprofessional
interestsArray (String)Interests associated with the profile
skillsArray (String)Skills associated with the profile
location_namesArray (String)list of all canonical location names associated with the person["berkeley, california, united states", "san francisco, california, united states"]
regionsArray (String)List of regions associated with the person["california, united states"]
countriesArray (Enum (String))Canonical Countrieslist of countries associated with a person["united states"]
street_addressesArray (Object)List of full parsed addresses associated with the personList of full parsed addresses associated with the person
street_addresses.street_addressStringThe street address associated with the location object455 fake st
street_addresses.address_line_2StringThe secondary street address associated with the location objectapartment 12
street_addresses.nameStringA string that appends location fields together to create a standard location fieldberkeley, california, united states
street_addresses.localityStringThe administrative locality associated with the location objectberkeley
street_addresses.metroEnum (String)Canonical MetrosThe metro area associated with the location objectsan francisco, california
street_addresses.regionStringThe administrative region associated with the location objectcalifornia
street_addresses.postal_codeStringThe postal code associated with the location object94704
street_addresses.countryStringThe country associated with the location objectunited states
street_addresses.geoStringThe geolocation associated with the location object in latitude, longitude format37.87,-122.27
street_addresses.continentEnum (String)Canonical ContinentsThe continent associated with the country in the location objectnorth america
experienceArray (Object)Experience objects associated with this person profile. When outputted as a csv, the indexing is 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 mergingchief executive officer and co-founder
experience.title.levelsArray (Enum (String))Canonical Job Title LevelsLevels associated with a title["cxo"]
experience.title.roleEnum (String)Canonical Job RolesA person's job title derived roleoperations
experience.title.sub_roleEnum (String)Canonical Job Sub RolesA person's job title derived subrole. Each subrole maps to a rolelogistics
experience.companyObjectA dictionary of information for the associated company
experience.company.idStringOur current NOT PERSISTENT ids that tie company data to the canonical datapeopledatalabs
experience.company.nameStringThe name associated with the companypeople data labs
experience.company.websiteStringThe website associated with the companypeopledatalabs.com
experience.company.foundedDate*Date string. YYYY-MM-DD. Represented as Int for Data License customers (see October 2021 Release Notes (v16))The year that the company was founded1911
experience.company.sizeEnum (String)Canonical Company SizesThe size range of the company51-200
experience.company.industryEnum (String)Canonical IndustriesThe industry associated with the companycomputer software
experience.company.linkedin_urlStringThe linkedin url associated with the companylinkedin.com/company/peopledatalabs
experience.company.linkedin_idStringThe linkedin id associated with the company1640694639
experience.company.facebook_urlStringThe facebook url associated with the companyfacebook.com/peopledatalabs
experience.company.twitter_urlStringThe twitter associated with the companytwitter.com/peopledatalabs
experience.start_dateDateDate string. YYYY-MM-DDIndicates the start period of the object. Can be accurate to the day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY)2015-03
experience.end_dateDateDate string. YYYY-MM-DDIndicates the end period of the object2011-07
experience.location_namesArray (String)Canonical locations associated with this particular job/experience object (where the person is working, which may or may not be where the company is headquartered.)["san francisco, california, united states"]
experience.is_primaryBooleanIndicates if the experience is the primary experience object in our dataset. This experience object will exist in the job_XXX fieldsTRUE
experience.company.locationObjectA dictionary of information for the associated company location
experience.company.location.street_addressStringCompany HQ address455 Market Street Suite 1690
experience.company.location.address_line_2StringThe adress line 2 associated with the company HQsuite 1690
experience.company.location.nameStringThe canonical location name associated with the company HQsan francisco, california, united states
experience.company.location.localityStringCompany localitysan francisco
experience.company.location.metroEnum (String)Canonical MetrosCompany metro areasan francisco, california
experience.company.location.regionStringCompany regioncalifornia
experience.company.location.countryEnum (String)Canonical CountriesCompany countryunited states
experience.company.location.postal_codeStringThe postal code associated with the company HQ94105
experience.company.location.continentEnum (String)Canonical ContinentsThe continent associated with the company HQnorth america
experience.company.location.geoStringThe geo code associated with the company HQ37.77,-122.41
educationArray (Object)Education objects associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
education.degreesArray (Enum (String))Canonical Education DegreesA list of canonical degrees associated with this education object["bachelors", "bachelors of arts"]
education.majorsArray (Enum (String))Canonical Education MajorsA list of majors associated with this education object["entrepreneurship"]
education.minorsArray (Enum (String))Canonical Education MajorsA list of minors associated with this education object["business"]
education.schoolObjectA dictionary of information for the associated school
education.school.idStringOur current NOT PERSISTENT ids that tie company data to the canonical dataa56df063-4562-4e59-bc4c-68b33c14df1e
education.school.nameStringThe name associated with the schooluniversity of oregon
education.school.websiteStringThe website associated with the school, could include subdomainsbusiness.uoregon.edu
education.school.domainStringThe website associated with the schooluoregon.edu
education.school.typeEnum (String)Canonical School TypesThe type of schoolpost-secondary institution
education.school.linkedin_urlStringThe linkedin url associated with the schoollinkedin.com/school/university-of-oregon
education.school.linkedin_idStringThe linkedin ID associated with the school19207
education.school.facebook_urlStringThe facebook url associated with the schoolfacebook.com/universityoforegon
education.school.twitter_urlStringThe twitter url associated with the schooltwitter.com/uoregon
education.school.locationObjectThe location associated with the school
education.school.location.nameStringThe canonical name of the location associated with the schooleugene, oregon, united states
education.school.location.localityStringThe locality associated with the schooleugene
education.school.location.regionStringThe region associated with the schooloregon
education.school.location.countryEnum (String)Canonical CountriesThe country associated with the schoolunited states
education.school.location.continentEnum (String)Canonical ContinentsThe continent associated with the schoolnorth america
education.start_dateDateDate string. YYYY-MM-DDIndicates the start period of the object2008-09
education.end_dateDateDate string. YYYY-MM-DDIndicates the end period of the object2013-06
education.gpaFloatThe gpa associated with the given degree2.23
profilesArray (Object)Social media profiles associated with this person profile
profiles.urlStringThe url of the social profilelinkedin.com/in/seanthorne
profiles.idStringthe persistent id related to this social profile (varies by social network)145991517
profiles.networkEnum (String)Canonical Profile NetworksThe network the profile exists onlinkedin
profiles.usernameStringThe username associated with the profileseanthorne
operation_idStringCurrently only in data license deliveries. Allows PDL employees to identify the timestamp and operations performed on the internal data to return a record in a delivery.acee3bde2e1a2cb7e75c57b80d5b7bc2d5de5b02e7ea51f91304c28df77251dc
version_statusObjectDeprecated in API ResponsesAllows customers 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 ResponsesList of IDs merged into this record since the last release["qEnOZ5Oh0poWnQ1luFBfVw_0000"]
version_status.current_versionStringDeprecated in API ResponsesCurrent version of the data15
version_status.previous_versionStringDeprecated in API ResponsesPrevious version of the data14
version_status.statusStringDeprecated in API Responses. Canonical Version StatusExplains what happened to this record between the previous release and the current releaseupdated
dataset_versionStringExplains the current major or minor release number.17.1

Person Risk Attributes

📘

Formatting Notes

The dot notation indicates that the property is one level deep inside 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
profiles.first_seenDateDate string. YYYY-MM-DDThe date when this profile was first associated to this record2017-06-02
profiles.last_seenDateDate string. YYYY-MM-DDThe date when this profile was last associated to this record2019-07-18
profiles.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this profile to this record17
emails.first_seenDateDate string. YYYY-MM-DDThe date when this email was first associated to this record2017-06-02
emails.last_seenDateDate string. YYYY-MM-DDThe date when this email was last associated to this record2019-07-18
emails.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this email to this record17
phonesArray (Object)A list of the phone numbers known to be associated with this record
phones.numberStringA phone number in E164 formatAn individual phone number associated with this record17095944554
phones.first_seenDateDate string. YYYY-MM-DDThe date when this phone number was first associated to this record2017-06-02
phones.last_seenDateDate string. YYYY-MM-DDThe date when this phone number was last associated to this record2019-07-18
phones.num_sourcesIntegerGreater than 0The number of sources that have contributed to the association of this phone number to this record17
street_addresses.first_seenDateDate string. YYYY-MM-DDThe date when this street address was first associated to this record
street_addresses.last_seenDateDate string. YYYY-MM-DDThe date when this street address was last associated to this record
street_addresses.num_sourcesIntegerGreater than 0The number of sources contributed that have contributed to the association of this street address to this record17
linkedin_connectionsIntegerTypically 0-500, some are the true values over 500The number of linkedin connections the person has432
facebook_friendsIntegerGreater than or equal to 0The number of facebook friends the person has3912
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 associated emails to this person record with a lower level of confidence than the currently-displayed ones in the emails arraysame as emails array
possible_phonesArray (String)Any additional associated phones to the person record with a lower level of confidence to the currently-displayed ones in the phone_numbers arraysame as phone_numbers array
possible_profilesArray (Object)Any additional associated profiles to the person record w/ a lower level of confidence to the currently-displayed ones in the profilessame as profiles array
possible_street_addressesArray (Object)Any additional associated addresses to the person record with a lower level of confidence to the currently-displayed ones in the street_addresses arraysame as street addresses array
possible_birth_datesArray (String)Any additional associated birth dates to the person record with a lower level of confidence to the currently-displayed one in the birth_date field["1991-05-26", "1992-05-26"]
possible_location_namesArray (String)Inferred potential locations the person has lived in based on phone area codes, university location, other associationssame as location_names array
experience.first_seenDateDate string. YYYY-MM-DDThe date when this professional position was first associated to this record in our data2016-10-12
experience.last_seenDateDate string. YYYY-MM-DDThe date when this professional position was last associated to this record in our data2022-01-04
job_historyArray (Object)Any additional professional positions associated to 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. YYYY-MM-DDThe date when this professional position was first associated to this record in our data2016-05-17
job_history.last_seenDateDate string. YYYY-MM-DDThe date when this professional position was last associated to this record in our data2020-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 profile172
first_seenDateDate string. YYYY-MM-DDThe date when this record was first created in our data2017-06-02

Premium Resume Fields

📘

Formatting Notes

The dot notation indicates that the property is one level deep inside 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. YYYY-MM-DDExpiration of certification2018-03
certifications.nameStringFree Text FieldInputted name of the certificationmachine learning certification
certifications.organizationStringFree Text FieldInputted organization awarding certificationcoursera
certifications.start_dateDateDate string. YYYY-MM-DDStart date of certification2019-04
education.rawArray (String)Free Text FieldRaw education input information. Parsed into the degrees/majors/minors fieldsbachelors of arts in entrepreneurship, business minor
education.school.rawArray (String)Free Text FieldRaw school namesuniversity of oregon
education.summaryStringFree Text Field, CasedUser-inputted summary of educationwhen i was at oregon i volunteered at a local homeless shelter 3 days a week
experience.company.rawArray (String)Free Text FieldRaw company namesgoogle -- analytics team
experience.company.tickerStringFree Text Field, capitalizedCompany Ticker, (only for public companies)GOOG
experience.company.typeEnum (String)Canonical Company TypesCompany Typepublic
experience.summaryStringFree Text Field, CasedUser-inputted summary of experienceworked on the "search analytics" team to understand our users better
experience.title.rawArray (String)Free Text FieldRaw titleschief executive officer and co-founder
inferred_salaryEnum (String)Canonical Inferred Salary Rangesinferred salary range -- Contact Us to learn how we infer70,000-85,000
inferred_years_experienceIntegerBetween 0 and 100Inferred years work experience7
job_company_tickerStringFree Text Field, capitalizedCurrent Company TickerGOOG
job_company_typeEnum (String)Canonical Company TypesCurrent Company Typepublic
job_onet_codeStringThe 8 digit O*NET code for a person’s current job title, following the 2018 SOC guidelines.”11-1011.00”
job_onet_major_groupStringThe O*NET Major Group associated with a person’s current job title.”Management Occupations”
job_onet_minor_groupStringThe O*NET Minor Group associated with a person’s current job title.“Top Executives”
job_onet_broad_occupationStringThe O*NET Broad Occupation category associated with a person’s current job title.“Chief Executives”
job_onet_specific_occupationStringThe O*NET Detailed Occupation category associated with a person’s current job title.“Chief Executives”
job_onet_titleStringA 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. e.g. The highest level of granularity for c-suite positions is Chief Executives.“Chief Technology Officer”
job_summaryStringFree Text Field, CasedUser-inputted summary of experienceworked on the "search analytics" team to understand our users better
languagesArray (Object)Self-identified languages spoken
languages.nameStringCanonical LanguagesName of the canonical language the person inputtedenglish
languages.proficiencyEnum (Integer)Score 1-5Self-identified proficiency score 1 (limited) - 5 (fluent)5
linkedin_connectionsIntegerTypically 0-500, some are the true values over 500Number of linkedin connections50
summaryStringFree Text Field, CasedSelf-written summaries tied to person profile (often linkedin summaries)growth-hacker and digital nomad

Did this page help you?