/person/identify

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. The API then scores and sorts all matching records that it returns based on the strength of their association with the input parameters.

Log in to see full request history
timestatususer agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

The person's full name, at least first and last

string

The person's first name

string

The person's last name

string

The person's middle name

string

A location in which a person lives

string

A street address in which the person lives

string

A locality in which the person lives

string

A state or region in which the person lives

string

A country in which the person lives

string

The postal code where the person lives. If there is no value for country, the postal code is assumed to be US

string

A name, website, or social url of a company where the person has worked

string

A name, website, or social url of a university or college the person has attended

string

A phone number the person has used

string

An email the person has used

string

A sha256 email hash

string

A social profile the person has used. https://docs.peopledatalabs.com/docs/social-networks

string

The person's LinkedIn ID

string

The person's birth date: either the year or a full birth date in the format YYYY-MM-DD

boolean
Defaults to false

Whether the output should have human-readable indentation

boolean
Defaults to false

Setting titlecase to true will titlecase the person data in 200 responses.

string

A comma-separated string of fields that you would like the response to include. Begin the string with a - if you would instead like to exclude the specified fields. If you would like to exclude all data from being returned, use data_include=""

boolean
Defaults to false

If true, the response will include the field matches.matched_on that contains a list of every query input that matched this profile

Headers
string
Defaults to application/json

The content type

Responses

400

Request contained either missing or invalid parameters

401

Request contained either missing or invalid key

402

You have reached your account maximum (all matches used)

404

No records were found matching your request

405

Request method is not allowed on the requested resource

429

An error occurred due to requests hitting the API too quickly

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json