Skip to main content

Before you begin

  • Create an API key.
  • Use cURL with jq, Python with requests, or Node.js 18 or later.
Replace YOUR_API_KEY with your API key.
1

Find a work email

Send a name and company. Set wait_seconds: 20 to wait up to 20 seconds for the Job to finish.
2

Read the result

If the Job finishes within the wait window, the request returns HTTP 200. Check status. For succeeded, read the work email in result.email:
HTTP 202 means the Job has not finished:
3

Poll if needed

If you receive HTTP 202, poll the Job until it finishes.
Async Jobs covers polling and retries. Batch Processing covers lists and files. Find Contacts lists the other contact types.

Find Contacts API Reference

Try the request in the API playground.
For older requests, see Legacy.