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 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 you are interested in and pass these as input parameters
  2. The Identify API will cleans input parameter values and search our Person Dataset for matching profiles using fuzzy matching logic
  3. Up to 20 of the the best matching profiles will be 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 Identify 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 full-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?