Person Schema

📘
Note
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 Name	Field Type	Short Description	Example
`id`	`String`	PDL persistent ID	qEnOZ5Oh0poWnQ1luFBfVw_0000
`full_name`	`String`	The first and the last name fields appended with a space	sean thorne
`first_name`	`String`	A person's first name	sean
`middle_initial`	`String`	A person's middle initial	f
`middle_name`	`String`	A person's middle name	fong
`last_initial`	`String`	The first letter of a person's last name	t
`last_name`	`String`	A person's last name	thorne
`gender`	`String`	The person's gender	male
`birth_year`	`Date`*	Approximated birth date associated with this person profile. If a profile has a birth_date, the birth_data_fuzzy field will match	1990
`birth_date`	`Date`	Birth date associated with this person profile	1990-12-03
`linkedin_url`	`String`	Main linkedin profile for this record based on source agreement	linkedin.com/in/seanthorne
`linkedin_username`	`String`	Main linkedin username for this record based on source agreement	seanthorne
`linkedin_id`	`String`	Main linkedin profile id for this record based on source agreement	145991517
`facebook_url`	`String`	facebook profile	facebook.com/deseanthorne
`facebook_username`	`String`	facebook username	deseanthorne
`facebook_id`	`String`	persistent facebook id associated with a person's facebook profile	1089351304
`twitter_url`	`String`	Twitter URL	twitter.com/seanthorne5
`twitter_username`	`String`	Twitter Username	seanthorne5
`github_url`	`String`	Main github profile for this record based on source agreement	github.com/deseanathan_thornolotheu
`github_username`	`String`	Main github profile username for this record based on source agreement	deseanathan_thornolotheu
`work_email`	`String`	Current Professional email	[email protected]
`personal_emails`	`List (String)`	List of all emails tagged as type = personal	["[email protected]", "[email protected]"]
`mobile_phone`	`String`	Highly confident direct dial mobile phone associated with this person	+17095944554
`industry`	`Enum (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_title`	`String`	A person's current job title	co-founder and chief executive officer
`job_title_role`	`Enum (String)`	A person's current job title derived role	operations
`job_title_sub_role`	`Enum (String)`	A person's job title derived subrole. Each subrole maps to a role	logistics
`job_title_levels`	`String`	A person's current job title derived levels	["cxo", "owner"]
`job_company_id`	`String`	A person's current company's PDL ID	peopledatalabs
`job_company_name`	`String`	A person's current company's name	people data labs
`job_company_website`	`String`	A person's current company's website	peopledatalabs.com
`job_company_size`	`String`	A person's current company's size range	51-200
`job_company_founded`	`Date`*	A person's current company's founded date	1911
`job_company_industry`	`Enum (String)`	A person's current company's industry	computer software
`job_company_linkedin_url`	`String`	A person's current company's linkedin url	linkedin.com/company/peopledatalabs
`job_company_linkedin_id`	`String`	A person's current company's linkedin id	1640694639
`job_company_facebook_url`	`String`	A person's current company's facebook url	facebook.com/peopledatalabs
`job_company_twitter_url`	`String`	A person's current company's twitter url	twitter.com/peopledatalabs
`job_company_location_name`	`String`	A person's current company's HQ canonical location	san francisco, california, united states
`job_company_location_locality`	`String`	A person's current company's HQ locality	san francisco
`job_company_location_metro`	`String`	A person's current company's HQ metro area	san francisco, california
`job_company_location_region`	`String`	A person's current company's HQ region	california
`job_company_location_geo`	`String`	A person's current company's HQ geo	37.77,-122.41
`job_company_location_street_address`	`String`	A person's current company's HQ street_address	455 Market Street Suite 1690
`job_company_location_address_line_2`	`String`	A person's current company's HQ address line 2	suite 1690
`job_company_location_postal_code`	`String`	A person's current company's HQ postal code	94105
`job_company_location_country`	`String`	A person's current company's HQ country	united states
`job_company_location_continent`	`String`	A person's current company's HQ continent	north america
`job_last_updated`	`Date`	Indicates the timestamp of the most recent source that agrees with this information	2018-11-05
`job_start_date`	`Date`	Indicates the start period of the object. Can be accurate to the day (YYYY-MM-DD), month (YYYY-MM) or year (YYYY)	2015-03
`location_name`	`String`	the current canonical location of the person	berkeley, california, united states
`location_locality`	`String`	the current locality of the person	berkeley
`location_metro`	`String`	the current MSA of the person	san francisco, california
`location_region`	`String`	the current region of the person	california
`location_country`	`String`	the current country of the person	united states
`location_continent`	`String`	the current continent of the person	north america
`location_street_address`	`String`	the current street address of the person	455 fake st
`location_address_line_2`	`String`	the current address line 2 of the person	apartment 12
`location_postal_code`	`String`	the current postal code of the person	94704
`location_geo`	`String`	the current geo of the person	37.87,-122.27
`location_last_updated`	`Date`	Indicates the timestamp of the most recent source that agrees with this information	2018-11-05
`phone_numbers`	`Array (String)`	Phone numbers associated with this person profile in E164 format	+17095944554
`emails`	`Array (Object)`	Emails associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
`emails.address`	`String`	The full parsed email	[email protected]
`emails.type`	`Enum (String)`	The type of email either current_professional, professional, personal or null	professional
`interests`	`Array (Object)`	Interests associated with the profile
`skills`	`Array (Object)`	Skills associated with the profile
`location_names`	`List (String)`	list of all canonical location names associated with the person	["berkeley, california, united states", "san francisco, california, united states"]
`regions`	`Array (String)`	List of regions associated with the person	["california, united states"]
`countries`	`Array (String)`	list of countries associated with a person	["united states"]
`street_addresses`	`Array (Object)`	List of full parsed addresses associated with the person	List of full parsed addresses associated with the person
`street_addresses.street_address`	`String`	The street address associated with the location object	455 fake st
`street_addresses.address_line_2`	`String`	The secondary street address associated with the location object	apartment 12
`street_addresses.name`	`String`	A string that appends location fields together to create a standard location field	berkeley, california, united states
`street_addresses.locality`	`String`	The administrative locality associated with the location object	berkeley
`street_addresses.metro`	`String`	The metro area associated with the location object	san francisco, california
`street_addresses.region`	`String`	The administrative region associated with the location object	california
`street_addresses.postal_code`	`String`	The postal code associated with the location object	94704
`street_addresses.country`	`String`	The country associated with the location object	united states
`street_addresses.geo`	`String`	The geolocation associated with the location object in latitude, longitude format	37.87,-122.27
`street_addresses.continent`	`Enum (String)`	The continent associated with the country in the location object	north america
`experience`	`Array (Object)`	Experience objects associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
`experience.title`	`Object`	A dictionary object that provides a raw title, canonized title, and level
`experience.title.name`	`String`	The 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.levels`	`Array (Enum (String))`	Levels associated with a title	["cxo"]
`experience.title.role`	`Enum (String)`	A person's job title derived role	operations
`experience.title.sub_role`	`Enum (String)`	A person's job title derived subrole. Each subrole maps to a role	logistics
`experience.company`	`Object`	A dictionary of information for the associated company
`experience.company.id`	`String`	Our current NOT PERSISTENT ids that tie company data to the canonical data	peopledatalabs
`experience.company.name`	`String`	The name associated with the company	people data labs
`experience.company.website`	`String`	The website associated with the company	peopledatalabs.com
`experience.company.founded`	`Date`*	The year that the company was founded	1911
`experience.company.size`	`Enum (String)`	The size range of the company	51-200
`experience.company.industry`	`Enum (String)`	The industry associated with the company	computer software
`experience.company.linkedin_url`	`String`	The linkedin url associated with the company	linkedin.com/company/peopledatalabs
`experience.company.linkedin_id`	`String`	The linkedin id associated with the company	1640694639
`experience.company.facebook_url`	`String`	The facebook url associated with the company	facebook.com/peopledatalabs
`experience.company.twitter_url`	`String`	The twitter associated with the company	twitter.com/peopledatalabs
`experience.start_date`	`Date`	Indicates 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_date`	`Date`	Indicates the end period of the object	2011-07
`experience.location_names`	`Array (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_primary`	`Boolean`	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.location`	`Object`	A dictionary of information for the associated company location
`experience.company.location.street_address`	`String`	Company HQ address	455 Market Street Suite 1690
`experience.company.location.address_line_2`	`String`	The adress line 2 associated with the company HQ	suite 1690
`experience.company.location.name`	`String`	The canonical location name associated with the company HQ	san francisco, california, united states
`experience.company.location.locality`	`String`	Company locality	san francisco
`experience.company.location.metro`	`String`	Company metro area	san francisco, california
`experience.company.location.region`	`String`	Company region	california
`experience.company.location.country`	`String`	Company country	united states
`experience.company.location.postal_code`	`String`	The postal code associated with the company HQ	94105
`experience.company.location.continent`	`String`	The continent associated with the company HQ	north america
`experience.company.location.geo`	`String`	The geo code associated with the company HQ	37.77,-122.41
`education`	`Array (Object)`	Education objects associated with this person profile. When outputted as a csv, the indexing is based on recency and associativity
`education.degrees`	`Array (String)`	A list of canonical degrees associated with this education object	["bachelors", "bachelors of arts"]
`education.majors`	`Array (String)`	A list of majors associated with this education object	["entrepreneurship"]
`education.minors`	`Array (String)`	A list of minors associated with this education object	["business"]
`education.school`	`Object`	A dictionary of information for the associated school
`education.school.id`	`String`	Our current NOT PERSISTENT ids that tie company data to the canonical data	a56df063-4562-4e59-bc4c-68b33c14df1e
`education.school.name`	`String`	The name associated with the school	university of oregon
`education.school.website`	`String`	The website associated with the school, could include subdomains	business.uoregon.edu
`education.school.domain`	`String`	The website associated with the school	uoregon.edu
`education.school.type`	`Enum (String)`	The type of school	post-secondary institution
`education.school.linkedin_url`	`String`	The linkedin url associated with the school	linkedin.com/school/university-of-oregon
`education.school.linkedin_id`	`String`	The linkedin ID associated with the school	19207
`education.school.facebook_url`	`String`	The facebook url associated with the school	facebook.com/universityoforegon
`education.school.twitter_url`	`String`	The twitter url associated with the school	twitter.com/uoregon
`education.school.location`	`Object`	The location associated with the school
`education.school.location.name`	`String`	The canonical name of the location associated with the school	eugene, oregon, united states
`education.school.location.locality`	`String`	The locality associated with the school	eugene
`education.school.location.region`	`String`	The region associated with the school	oregon
`education.school.location.country`	`String`	The country associated with the school	united states
`education.school.location.continent`	`String`	The continent associated with the school	north america
`education.start_date`	`Date`	Indicates the start period of the object	2008-09
`education.end_date`	`Date`	Indicates the end period of the object	2013-06
`education.gpa`	`Decimal`	The gpa associated with the given degree	2.23
`profiles`	`Array (Object)`	Social media profiles associated with this person profile
`profiles.url`	`String`	The url of the social profile	linkedin.com/in/seanthorne
`profiles.id`	`String`	the persistent id related to this social profile (varies by social network)	145991517
`profiles.network`	`Enum (String)`	The network the profile exists on	linkedin
`profiles.username`	`String`	The username associated with the profile	seanthorne
`operation_id`	`String`	Currently 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_status`	`Object`	Allows 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.contains`	`List (String)`	List of IDs merged into this record since the last release	["qEnOZ5Oh0poWnQ1luFBfVw_0000"]
`version_status.current_version`	String	Current version of the data	15.0
`version_status.previous_version`	String	Previous version of the data	14.0
`version_status.status`	String	Explains what happened to this record between the previous release and the current release	updated

Represented as Int for Data License customers (see October 2021 Release Notes (v16))

People Data Labs

People Data Labs Documentation

Person Schema

📘
Note

Person Schema

Suggested Edits are limited on API Reference Pages

📘Note

📘
Note