Input Parameters - Person Identify API - People Data Labs Documentation

Required Parameters

A valid Person Identify API request must include at least one of the following:

profile
email
phone
email_hash
lid
street_address
locality
region
company
school
location
postal_code
name
first_name AND last_name

`api_key`

Type	Description	Default	Example
`String`	Your secret API key.

Your API Key must be included in either the request header or the api_key parameter. For more information about request authentication, see the Authentication page.

Optional Parameters

`name`

Type	Description	Example
`String`	The person’s full name, at least the first and last.	`Jennifer C. Jackson`

`first_name`

Type	Description	Example
`String`	The person’s first name.	`Jennifer`

`last_name`

Type	Description	Example
`String`	The person’s last name.	`Jackson`

`middle_name`

Type	Description	Example
`String`	The person’s middle name.	`Cassandra`

`location`

Type	Description	Example
`String`	The location where a person lives. This can be anything from a street address to a country name.	`Medford, OR USA`

`street_address`

Type	Description	Example
`String`	The street address where the person lives.	`1234 Main Street`

`locality`

Type	Description	Example
`String`	The locality where the person lives.	`Boise`

`region`

Type	Description	Example
`String`	The state or region where the person lives.	`Idaho`

`country`

Type	Description	Example
`String`	The country where the person lives.	`United States`

`postal_code`

Type	Description	Example
`String`	The postal code where the person lives. If there is no value for country, the postal code is assumed to be US.	`83701`

`company`

Type	Description	Example
`String`	The name, website, or social URL of a company where the person has worked.	`Amazon`

`school`

Type	Description	Example
`String`	The name, website, or social URL of a university or college the person has attended.	`University of Iowa`

`phone`

Type	Description	Example
`String`	A phone number the person has used. Input must begin with `+[country code]` for a match to be returned.	`+1 555-234-1234`

`email`

Type	Description	Example
`String`	An email the person has used.	`renee.c.paulsen1959@yahoo.com`

`email_hash`

Type	Description	Example
`String`	The SHA-256 or MD5 email hash for an email the person has used.	`e206e6cd7fa5f9499fd6d2d943dcf7d9c1469bad351061483f5ce7181663b8d4`

`profile`

Type	Description	Example
`String`	A social profile that the person has used (see list of supported social profiles).	`https://linkedin.com/in/seanthorne`

`lid`

Type	Description	Example
`String`	The person’s LinkedIn ID.	`145991517`

`birth_date`

Type	Description	Example
`String`	The person’s birth date: either the year or a full birth date in the format `YYYY-MM-DD`.	`1996-10-01`

`pretty`

Type	Description	Default	Example
`Boolean`	Whether the output should have human-readable indentation.	`false`	`true`

`titlecase`

Type	Description	Default	Example
`Boolean`	All text in API responses returns as lowercase by default. Setting `titlecase` to `true` will titlecase response data instead.	`false`	`true`

`data_include`

Type	Description	Default	Example
`String`	A comma-separated string of fields that you want the response to include.		`"full_name,emails.address"`

`include_if_matched`

Type	Description	Default	Example
`Boolean`	If `true`, the response will include the field `matches.matched_on` that contains a list of every query input that matched this profile.	`false`	`true`

As an example, if we wanted to enrich Sean Thorne using the following query:

JSON

{
   "first_name": "sean",
   "last_name": "thorne",
   "company": "people data labs",
   "location": "abu dhabi",
   "include_if_matched": true
}

Since Sean’s location is in California and not Abu Dhabi in the dataset, the response would contain:

JSON

{
   "matched": [
        "company",
        "name"
    ]
}

​Required Parameters

​api_key

​Optional Parameters

​name

​first_name

​last_name

​middle_name

​location

​street_address

​locality

​region

​country

​postal_code

​company

​school

​phone

​email

​email_hash

​profile

​lid

​birth_date

​pretty

​titlecase

​data_include

​include_if_matched