Find Email by Name and Domain (Unlimited Plans)
Find a person’s deliverable email address from their name and company domain on an unlimited plan. Counts against your plan’s monthly cap instead of credits.
403 with code: wrong_key_plan; if the plan’s subscription has lapsed, the key returns 402 with code: subscription_inactive until it is reinstated.
Metering
- Each returned response counts 1 request against your plan’s monthly single-lookup cap (100,000, 200,000, or 400,000 per billing period depending on plan), including
status: unknownoutcomes. - No credits are charged. The
credits_consumedfield is retained for wire compatibility and reads0; no credits move on unlimited plans. - The consumed unit is released only when OrbiSearch infrastructure cannot complete the request (
502). Retry the request. - When the cap is reached, the endpoint returns
429withcode: monthly_quota_exceededand aRetry-Aftergiving the seconds until your billing period ends. Check consumption at any time via GET /v1/unlimited/usage.
Rate limits
Requests are limited to your plan’s per-second rate, per account: 10 requests per second on Starter, 15 on Standard, 20 on Professional. The limit is keyed to your account, not the key, so creating additional keys does not raise it. TheX-RateLimit-* response headers describe this window. Exceeding it returns 429 with code: rate_limited; see errors for handling.Authorizations
API key for authentication
Body
Find a deliverable email from a name and company domain.
Company domain to search within.
3 - 255"acme.com"
Person's first name. Optional individually — provide at least one of first or last name.
255"Jane"
Person's last name. Optional individually — provide at least one of first or last name.
255"Doe"
Lookup timeout in seconds (30–97).
30 <= x <= 9797
Response
Successful Response
Lookup result — best deliverable email found for a (first_name, last_name, domain).
Lookup status: safe (a deliverable address was found and is in the email field) or unknown (no deliverable address was found, or the lookup timed out; the email field is null).
safe, unknown ^(safe|unknown)$"safe"
Plain-English explanation of the lookup result.
"Safe to email. The mailbox exists and is deliverable."
Email service provider of the returned address (Google Workspace, Microsoft Outlook, etc.).
"Google Workspace"
Credits charged for this lookup: 1 on pay-as-you-go keys, 0 on unlimited plans (no credits move).
1
The first name supplied in the request.
"Jane"
The last name supplied in the request.
"Doe"
The domain supplied in the request.
"acme.com"
The deliverable email address discovered for this person at this domain. Null when no deliverable address could be confirmed.
"jane.doe@acme.com"
Specific reason for the status: deliverable (a deliverable address was found — only returned with status=safe), no_address_found (no deliverable address was found for this person at this domain — only returned with status=unknown), timeout (the caller's timeout parameter exhausted before the lookup completed; retry with a larger timeout — only returned from /v1/email-lookup, never from /v1/bulk-lookup, since bulk lookups have no caller-tunable timeout). All substatuses are billable; refunds happen only when OrbiSearch infrastructure cannot complete the request.
deliverable, no_address_found, timeout ^(deliverable|no_address_found|timeout)$"deliverable"
The main mail server the domain uses to receive email. Null if the domain has no mail server configured.
"aspmx.l.google.com"
True if the domain accepts mail for any username (catch-all). Null if we could not determine whether the domain is catch-all.
false
True if the domain is protected by a secure email gateway — Proofpoint, Mimecast, Barracuda, or Trend Micro.
false
True if this is a temporary/disposable email service, false if not, null if unknown.
false
True if this is a generic role-based email (info@, support@, etc.), false if not, null if unknown.
false
True if this is from a free email provider (gmail.com, yahoo.com, etc.), false if not, null if unknown.
false
How certain we are in the verdict on a 0–100 scale. See EmailVerificationResponse.confidence for the full scale.
0 <= x <= 10099