Skip to main content
This page uses the original route, which keeps working. For new integrations, use Find Contacts. Legacy maps each original route to its /v1 replacement.
Response

Request

Lead field names are matched loosely: linkedin or linkedin_url, name or first_name and last_name, company or company_name, domain or website.

Response

email holds one [address, status, type] tuple: the first deliverable address, or the best remaining one if none is deliverable. Other candidates are in other_emails; addresses that fail verification are left out. When nothing is found, email is absent. Type is COMPANY or PERSONAL. cost_credits is what the request charged; cost_cents is deprecated.
Find Email always searches, even if the lead already has an email. It replaces your address when it finds one; when it finds nothing, your address comes back unchecked with status UNKNOWN. To check a specific address, use Verify Email.

Async and bulk

Poll async jobs with GET /job-status/{task_id}. For the result shape in job status and webhooks, see Async Jobs. See Credit Costs for what it costs.