Skip to main content
Have an email or phone and need the person? Use Reverse Lookup.

Request

Response

Your request returns a Job. When a single-person Job reaches succeeded, read its contact details from result.
object
Contact details on a finished single-person Job.
Contacts uses uppercase email statuses. Verify Email returns lowercase valid, risky, invalid or unknown.

Parameters

Send exactly one of person, people or input_file_id.
object
Person to look up. Accepts a name, company, LinkedIn URL and other known fields.
object[]
People to look up. From 1 to 100,000 records.
string
Uploaded file of people.
string[]
required
One to three unique contact types.
boolean
default:true
If true, verifies found addresses. If false, returns the first address with status UNKNOWN. Does not affect phones.
integer
default:5
Seconds to wait for the Job to finish, from 0 to 20.
string
HTTPS callback URL.
Records accept a custom_id to match each result to your records.

Contact types

See Credit Costs for more information.

Try it

Open the Find Contacts API Reference playground.
For older requests, see Find Email and Find Phone.