Skip to main content
GET
GET
Retrieve the result of a previously launched email search using its unique ID. Authenticate every request with your API key in the x-api-key header.
Using a webhook allows you to skip calling this GET endpoint, as you will be notified the second your search is finished. See How Webhooks Work.

Query Parameters

string
required
The unique identifier returned from the POST request

Response

200 — Search completed

string
The discovered email address
string
valid (email found) or invalid (email not found). Why binary?
number
Final cost of the search once refunds are applied: 1 for an email found, 0 for an email not found (0.25 for a search from a LinkedIn profile URL or for an account whose success rate is abnormally low, see Credits & billing). A search from a LinkedIn profile URL that fails because of an issue on our side costs 0: see Results of a search from a LinkedIn profile URL.
object
Contact and company information. For a search from a LinkedIn profile URL, only present when an email is found.
object
Custom properties passed in the original request, returned as-is
string
Search from a LinkedIn profile URL only. How the search ended: found, profile_not_found, no_current_company, email_not_found or lookup_failed. See Results of a search from a LinkedIn profile URL.
string
Search from a LinkedIn profile URL only. The linkedin_url you sent.

202 — Search still in progress

string
ongoing — the search is not finished yet. Poll again shortly, or use a webhook to be notified automatically. Retrieving a result does not consume credits; see Credits & billing.

Error Responses

See Error handling for the full list of status codes and response formats.

Results of a search from a LinkedIn profile URL

A search launched from a LinkedIn profile URL keeps the binary qualification and adds two fields: linkedin_status, which tells you how the search ended, and linkedin_url, the URL you sent. When the email is found, info gives the name and the company read from the profile: firstname, lastname, company_name and company_domain, plus gender when retrieve_gender is true. In every other case, the response has no email and no info: it never says who the profile belongs to. If the email or the profile is on your suppression list, the email found is withheld: the result reads email_not_found and costs 1 credit, like a found email. While the search is running, the endpoint returns the usual 202 with qualification: "ongoing".

Next steps

Find an email

Launch a single email search to obtain a search id.

Get bulk results

Retrieve the results of a bulk email search.

Webhooks

Get notified automatically when a search completes.

Authentication

How to pass your API key in the x-api-key header.