Skip to content
/
Single work email lookup

Single work email lookup

Request

Start a work email lookup and return immediately with a job id. Identify the person either by first_name, last_name and domain, or by linkedin_public_identifier, in which case the name and the domain of their current employer are taken from the Forager dataset. The lookup itself runs asynchronously because proving an address is deliverable takes longer than a request should wait: poll the returned status_check_url until status is completed or failed. Credits are charged once, only when an address is found, and polling is always free. This endpoint is rate limited for interactive use - for enrichment runs use the bulk endpoint, which is both faster and cheaper for us to serve.

Security
Api-Key
Path
account_idintegerrequired
Body
first_namestring
Default:""
last_namestring
Default:""
domainstring

Company domain, e.g. "acme.com". A full URL is accepted and reduced to its domain.

Default:""
linkedin_public_identifierstring

LinkedIn person "Public identifier/Slug" - "linkedin.com/in/!slug!/".

Default:""
webhook_urlstring, <= 2048 characters

Optional https URL we POST the results to when the batch completes, so you need not poll. Put any secret used to authenticate the callback in the URL query string; it is never returned by the poll endpoints or written to logs. Omit to poll only.

Default:""
curl -i -X POST \
  'https://api-v2.forager.ai/api/v2/{account_id}/datastorage/person_contacts_lookup/work_emails/' \
  -H 'Content-Type: application/json' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE' \
  -d '{
    "first_name": "",
    "last_name": "",
    "domain": "",
    "linkedin_public_identifier": "",
    "webhook_url": ""
  }'

Responses

Bodyapplication/json
job_idstring, (uuid)read-onlyrequired
statusstringread-onlyrequired
status_check_urlstringread-onlyrequired
webhook_urlstringread-onlyrequired
Response
{
  "job_id": "453bd7d7-5355-4d6d-a38e-d9e7eb218c3f",
  "status": "string",
  "status_check_url": "string",
  "webhook_url": "string"
}