Identify API

Discover associated profiles using expanded search inputs


The Identify API allows you to use broad search inputs to recover multiple records from our person dataset. In particular, this endpoint enables functionality such as searching by just 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. All matching records returned are scored and sorted by the strength of their association with the input parameters.


How does the Identify API compare against other PDL Endpoints?

See our FAQ section for a detailed breakdown about the differences between the Identify API and our other person-related products.

Use Cases

The key use cases intended for this endpoint are those involving building out comprehensive profiles for specific individuals such as:

  • Investigations and forensics
  • Fraud risk modeling
  • Identity modeling for customer onboarding and other KYC applications

How it Works

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

  1. You specify some characteristics about the identity that you are interested in and pass these as input parameters.
  2. The Identify API cleans the input parameter values and searches our Person Dataset for matching profiles using fuzzy-matching logic.
  3. Up to 20 of the the best matching profiles are returned in the API response, ranked by their match score

What's Next

Please checkout the following pages for more information on the Identify API:

QuickstartA quick hands-on introduction to the API with simple code examples.
ReferenceDetailed overviews of the technical specifications and usage constraints.
Input ParametersIn-depth explanations of the input parameters supported by the API.
Output ResponseIn-depth explanations of the output response object returned by the API.
ExamplesA collection of running code examples and walkthroughs illustrating various use cases and applications of the API.
FAQsAnswers to commonly asked questions and other good-to-know information.

Did this page help you?