Skip to main content
Email lookup lets you find a person’s deliverable email address when you only have their first name, last name, and the domain of the company they work at. Send the three fields, get a verified email back.

​
When to use email lookup

  • Contact enrichment — you’ve collected a name and company from a form, LinkedIn, or a CSV and need a reachable email to act on it.
  • Lead research — you know who you want to contact and where they work, but not the exact address.
  • Reconnecting with known contacts — after a company moves off a free email provider to a custom domain.
For verifying an address you already have, use single verification. For verifying a list of known addresses, use bulk verification.

​
Making a request

To look up an email, send a POST request to /v1/email-lookup with the person’s first name, last name, and company domain in the JSON body. Include your API key in the X-API-Key header.
1

Get your API key

Sign in to the OrbiSearch dashboard and copy your API key.
2

Send the request

Call POST /v1/email-lookup with your key in the request header.
curl --request POST \
  --url "https://api.orbisearch.com/v1/email-lookup" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "first_name": "Jane",
    "last_name": "Doe",
    "domain": "acme.com"
  }'
3

Read the response

When a deliverable address is found, the response includes the discovered email and the same enrichment fields as single verification.
{
  "email": "[email protected]",
  "status": "safe",
  "substatus": "deliverable",
  "explanation": "Safe to email. The mailbox exists and is deliverable.",
  "email_provider": "Google Workspace",
  "mx_record": "aspmx.l.google.com",
  "is_domain_catch_all": false,
  "is_secure_email_gateway": false,
  "is_disposable": false,
  "is_role_account": false,
  "is_free": false,
  "credits_consumed": 1,
  "first_name": "Jane",
  "last_name": "Doe",
  "domain": "acme.com"
}

​
Interpreting the response

The top-level status uses the same vocabulary as /v1/verify:
statussubstatusWhat it means
safedeliverableWe found a deliverable address for this person. The email field contains it.
unknownno_address_foundWe couldn’t confirm a deliverable address for this person at this domain. The email field is null.
unknowntimeoutThe lookup hit the per-request time budget before completing. You can retry with a higher timeout value.
In every case, the response echoes the first_name, last_name, and domain you sent (with casing and whitespace cleaned up), and includes credits_consumed. When a deliverable address is found, the full set of verification fields (email_provider, mx_record, enrichment flags) is populated — see Single Verification: Response Fields for their meaning. When email is null, don’t send to that person at that domain — we couldn’t find a deliverable address for them.

​
Pricing

Each lookup costs 1 credit. You are charged on a hit (safe), on a clean miss (no_address_found), and on a timeout. You are not charged, and the credit is refunded automatically, if our lookup service is temporarily unavailable (502). Results are cached for 24 hours. Looking up the same person (same first name, last name, and domain, ignoring casing and whitespace) within that window returns the cached result at no credit cost.

​
Rate limits

This endpoint shares the 20 requests per second per API key limit with /v1/verify and /v1/bulk.

​
The timeout parameter

By default, OrbiSearch waits up to 90 seconds for the lookup to complete. You can override this with the timeout field in the request body (minimum 3, maximum 120, in seconds). 
curl --request POST \
  --url "https://api.orbisearch.com/v1/email-lookup" \
  --header "X-API-Key: YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "first_name": "Jane",
    "last_name": "Doe",
    "domain": "acme.com",
    "timeout": 60
  }'
If the lookup hits the timeout, you receive a status: unknown / substatus: timeout response. The credit is charged — the lookup was attempted — but you can retry with a larger timeout for more headroom.