Input Parameters - Person Retrieve API

Required Parameters

`person_id`

Type	Description	Example
`String`	The PDL Persistent ID for a record in our Person Dataset.	`qEnOZ5Oh0poWnQ1luFBfVw_0000`

When calling the Person Retrieve API in URL, you must specify this as part of the endpoint URL.

You must use a Persistent ID for the person_id. If the provided ID does not represent a record from our Person Dataset, then the Person Retrieve API will return a 404 Not Found error.

📘
Using the person_id Parameter in URL
When calling the Person Retrieve API in URL, you must pass the person_id parameter as part of the endpoint path rather than as a URL parameter.
For example, using the ID qEnOZ5Oh0poWnQ1luFBfVw_0000:

Correct: v5/person/retrieve/qEnOZ5Oh0poWnQ1luFBfVw_0000

Incorrect: v5/person/retrieve?person_id=qEnOZ5Oh0poWnQ1luFBfVw_0000

Optional Parameters

`pretty`

Type	Description	Default	Example
`Boolean`	Whether the output should have human-readable indentation.	`false`	`true`

`api_key`

Type	Description	Default	Example
`String`	Your secret API key.

Your API Key must be included in either the request header or the api_key parameter. For more information about request authentication, see the Authentication page.

`filter_updated`

Type	Description	Default	Example
`Enum (String)`	Which Person Data field changes count as an updated record.		`job_change`

Use this parameter to filter which changes to person records count as an update. If you include this parameter in your request, only changes to the parameter-specific fields will count as an update.

If this parameter is not included in the request, any changes to the record (new data source, any field value change) will count as an update.

Supported Filters

Filter Name	Update Based On
`education`	`education`
`job_change`	`job_company_id` `job_title`
`location`	`location_name` `location_locality` `location_metro` `location_region` `location_country` `location_continent` `location_street_address` `location_address_line_2` `location_postal_code` `location_geo`
`mobile_phone_number`	`mobile_phone`
`personal_emails`	`personal_emails` `recommended_personal_email`
`phone_number`	`mobile_phone` `phone_numbers`
`social_profile`	`linkedin_url` `linkedin_username` `linkedin_id` `facebook_url` `facebook_username` `facebook_id` `twitter_url` `twitter_username` `github_url` `github_username`
`work_email`	`work_email`

Using Multiple Filters

The Retrieve API supports using multiple filters in the same request. For example, if you use both the job_change and location filters, a match will be returned if any of the associated fields for either filter have been updated (logical OR).

To use multiple filters, set filter_updated to a comma-separated string containing each filter name.

curl -X GET -G \
  'https://api.peopledatalabs.com/v5/person/retrieve/RECORD_ID_TO_RETRIEVE'\
  -H 'X-Api-Key: xxxx' \
  --data-urlencode 'filter_updated=job_change,location'