> ## 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](https://docs.peopledatalabs.com/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](https://docs.peopledatalabs.com/docs/output-response-person-identify-api#matchesmatch_score).

<Image title="Person Identify API Summary.svg" alt={960} align="center" width="100%" src="https://files.readme.io/82f656f-Person_Identify_API_Summary.svg" />

> 📘 How Does the Person Identify API Compare with Other Person-Related Endpoints?
>
> See our [Introduction](https://docs.peopledatalabs.com/docs/introduction#the-differences-between-our-person-related-apis) for a detailed breakdown regarding the differences between the Person Identify API and our other person-related products.

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

***

<Image align="center" src="https://files.readme.io/891be0ed02ce4959796635e8174b6ed7798a85f2595404a0ac7609c814e3a71b-Recruiting_Banner_for_Docs.png" />

*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) →*