Person Retrieve API

Directly look up person profiles by their PDL ID


The Person Retrieve API allows you to use a PDL Person ID (such as qEnOZ5Oh0poWnQ1luFBfVw_0000) to return data associated with that ID. A PDL ID is a unique and permanent identifier for each record in our dataset, so this endpoint allows you to directly retrieve data for the exact record that you are interested in (see Persistent IDs).


The most common use case for this endpoint is to update or retrieve records for an ID that you already have (typically from another endpoint or from your data license file.)


The Person Retrieve API allows you to directly retrieve the most up-to-date person record from our dataset using a PDL Person ID.

What's Next

Please check out the following pages for more information on the Person Retrieve API:

QuickstartA quick hands-on introduction to the API with simple code examples.
ReferenceDetailed descriptions of the technical specifications and usage constraints.
Input ParametersIn-depth explanations of the input parameters that the API supports.
Output ResponseIn-depth explanations of the output response object that the API returns.
ExamplesA collection of functional examples and walkthroughs that illustrate various use cases and applications of the API.
FAQsAnswers to commonly asked questions and other good-to-know information.
Bulk Person Retrieve APIA supporting functionality to retrieve multiple profiles in the same request.
Webhook for Person Retrieve APIAn alternative method for retrieving only updated profiles using a custom webhook.