> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peopledatalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Person Retrieve API

> *Directly look up person profiles by their PDL ID*

## Overview

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](/docs/persistent-ids)).

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/623f57d-Person_Retrieve_API_Summary.svg?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=562740f47c4c6a6bf7786b3d327298ad" width="100%" align="center" data-transcend-suppress data-path="images/docs/623f57d-Person_Retrieve_API_Summary.svg" />
</Frame>

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.)

<Frame caption="The Person Retrieve API allows you to directly retrieve the most up-to-date person record from our dataset using a [PDL Person ID](/docs/archived-input-parameters-person-retrieve-api-archived#person_id).">
  <img src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/c5de354-Person_Retrieve_API_Diagram.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=2306b249c9832010f453a7ef801bc1f0" align="center" data-transcend-suppress width="8210" height="4310" data-path="images/docs/c5de354-Person_Retrieve_API_Diagram.png" />
</Frame>

***

## What's Next

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

| Page                                                                     | Description                                                                                                         |
| :----------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------ |
| [Quickstart](/docs/quickstart-person-retrieve-api)                       | A quick hands-on introduction to the API with simple code examples.                                                 |
| [Reference](/docs/reference-person-retrieve-api)                         | Detailed descriptions of the technical specifications and usage constraints.                                        |
| [Input Parameters](/docs/input-parameters-person-retrieve-api)           | In-depth explanations of the input parameters that the API supports.                                                |
| [Output Response](/docs/output-response-person-retrieve-api)             | In-depth explanations of the output response object that the API returns.                                           |
| [Examples](/docs/examples-person-retrieve-api)                           | A collection of functional examples and walkthroughs that illustrate various use cases and applications of the API. |
| [FAQs](/docs/faqs-person-retrieve-api)                                   | Answers to commonly asked questions and other good-to-know information.                                             |
| [Bulk Person Retrieve API](/docs/bulk-person-retrieve)                   | A supporting functionality to retrieve multiple profiles in the same request.                                       |
| [Webhook for Person Retrieve API](/docs/webhook-for-person-retrieve-api) | An alternative method for retrieving only updated profiles using a custom webhook.                                  |


## Related topics

- [October 2021 Release Notes](/changelog/october-2021-release-notes-v16.md)
- [April 2022 Release Notes](/changelog/april-2022-release-notes-v18.md)
- [July 2022 Release Notes](/changelog/july-2022-release-notes-v19.md)
- [April 2023 Release Notes](/changelog/april-2023-release-notes-v22.md)
- [January 2023 Release Notes](/changelog/january-2023-release-notes-v21.md)
