> ## 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 Identify API

## Overview

The Person Identify API allows you to use broad search inputs to retrieve multiple records from our person dataset. In particular, this endpoint enables functionality such as searching through a single identifying attribute, such as name, email, phone number, company, school or location, in addition to using any combination of these attributes [and more](/docs/reference-person-identify-api#input-parameters). The API then scores and sorts all matching records that it returns based on the [strength of their association with the input parameters](/docs/output-response-person-identify-api#matchesmatch_score).

<Frame>
  <img src="https://mintcdn.com/peopledatalabs/zUi8mJdU3Bt5uwAA/images/docs/82f656f-Person_Identify_API_Summary.png?fit=max&auto=format&n=zUi8mJdU3Bt5uwAA&q=85&s=e90a37f916a357ce0319fdd014ad0a8e" width="100%" align="center" data-transcend-suppress data-path="images/docs/82f656f-Person_Identify_API_Summary.png" />
</Frame>

<Warning>
  **Warning: Credit Usage**

  Each call that you make to the Person Identify API will consume one credit, **regardless of the number of profiles that the API returns**.

  This behavior differs from that of our other APIs, which consume one credit for each profile that they return.
</Warning>

## Use Cases

A key use case for this endpoint is building comprehensive profiles for specific individuals, such as in the areas of:

* Investigations and forensics
* Fraud risk modeling
* Identity modeling for customer onboarding and other [KYC](https://en.wikipedia.org/wiki/Know_your_customer) applications

## How it Works

At a high level, the Person Identify API works as follows:

1. You specify some characteristics about the identity that you are interested in and pass these as [input parameters](/docs/identify-api-input-parameters) to the API.
2. The API [cleans](/docs/cleaner-apis) the input parameter values and searches our Person Dataset for matching profiles using fuzzy-matching logic.
3. The API returns up to 20 of the the best matching profiles in its response while ranking them by their [match score](/docs/identify-api-output-response#matchesmatch_score).

## What's Next

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

| Page                                                           | Description                                                                                                              |
| -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| [Quickstart](/docs/quickstart-person-identify-api)             | A quick hands-on introduction to the API with simple code examples.                                                      |
| [Reference](/docs/reference-person-identify-api)               | Detailed descriptions of the technical specifications and usage constraints.                                             |
| [Input Parameters](/docs/input-parameters-person-identify-api) | In-depth explanations of the input parameters that the API supports.                                                     |
| [Output Response](/docs/output-response-person-identify-api)   | In-depth explanations of the output response object that the API returns.                                                |
| [Examples](/docs/examples-person-identify-api)                 | A collection of functional code examples and walkthroughs that illustrate various use cases and applications of the API. |
| [FAQs](/docs/faqs-person-identify-api)                         | Answers to commonly asked questions and other good-to-know information.                                                  |

***

<Frame>
  <img align="center" src="https://mintcdn.com/peopledatalabs/YteP5zgY1fC23mEV/images/docs/891be0ed02ce4959796635e8174b6ed7798a85f2595404a0ac7609c814e3a71b-Recruiting_Banner_for_Docs.png?fit=max&auto=format&n=YteP5zgY1fC23mEV&q=85&s=abe1365e54a2f16de90de429336be8de" data-transcend-suppress width="1685" height="215" data-path="images/docs/891be0ed02ce4959796635e8174b6ed7798a85f2595404a0ac7609c814e3a71b-Recruiting_Banner_for_Docs.png" />
</Frame>

*Know someone who’d thrive building data products and helping us launch what’s next? We’d love to meet!*

*Check out our [open roles](https://www.peopledatalabs.com/company?utm_source=docs\&utm_medium=footer\&utm_campaign=cta#jobs) →*

<br />


## Related topics

- [Person Endpoints](/docs/person-endpoints.md)
- [Reference - Person Identify API](/docs/reference-person-identify-api.md)
- [Quickstart - Person Identify API](/docs/quickstart-person-identify-api.md)
- [Examples - Person Identify API](/docs/examples-person-identify-api.md)
- [FAQs - Person Identify API](/docs/faqs-person-identify-api.md)