Find Email

Send what you know about a person and get back a verified email address.

curl -X POST "https://api.sixtyfour.ai/find-email" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "lead": { "name": "Saarth Shah", "company": "Sixtyfour" } }'

import requests

response = requests.post(
    "https://api.sixtyfour.ai/find-email",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={"lead": {"name": "Saarth Shah", "company": "Sixtyfour"}},
)
response.raise_for_status()
lead = response.json()

const response = await fetch("https://api.sixtyfour.ai/find-email", {
  method: "POST",
  headers: { "x-api-key": "YOUR_API_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({ lead: { name: "Saarth Shah", company: "Sixtyfour" } }),
});
if (!response.ok) throw new Error(await response.text());
const lead = await response.json();

Response

{
  "name": "Saarth Shah",
  "company": "Sixtyfour",
  "email": [["saarth@sixtyfour.ai", "OK", "COMPANY"]],
  "other_emails": [{ "email": "saarth.shah@sixtyfour.ai", "status": "RISKY" }],
  "cost_cents": 5,
  "cost_credits": 0.5
}

Request

Field	Type	Default	Description
`lead`	object	Required	The person. Send a LinkedIn URL for the best match, or a name with a company or domain. Other fields come back unchanged.
`mode`	string	`PROFESSIONAL`	`PROFESSIONAL` finds a work address. `PERSONAL` finds a personal mailbox and returns it in `personal_email` and `personal_other_emails`.
`verify_emails`	boolean	`true`	Check addresses with the mail server. With `false`, you get the first address found with status `UNKNOWN`.
`webhook_url`	string	—	Async only. HTTPS URL that receives the result. See Outgoing Webhooks.

Lead field names are matched loosely: linkedin or linkedin_url, name or first_name and last_name, company or company_name, domain or website.

Response

email holds one [address, status, type] tuple: the first deliverable address, or the best remaining one if none is deliverable. Other candidates are in other_emails; addresses that fail verification are left out. When nothing is found, email is absent.

Status	Meaning
`OK`	The mail server accepted the address.
`RISKY`	It can receive mail, but delivery is uncertain, usually because the domain accepts every address.
`UNKNOWN`	Verification was inconclusive, or the address was not checked.

Type is COMPANY or PERSONAL. cost_credits is what the request charged; cost_cents is the legacy field.

Find Email always searches, even if the lead already has an email. It replaces your address when it finds one; when it finds nothing, your address comes back unchecked with status UNKNOWN. To check a specific address, use Verify Email.

Async and bulk

Endpoint	Body	Returns
`POST /find-email`	`lead`	The lead
`POST /find-email-async`	`lead`	A `task_id`
`POST /find-email-bulk`	`leads`, 1 to 100	`{ leads, total_leads, emails_found, cost_cents, cost_credits, mode }`
`POST /find-email-bulk-async`	`leads`, 1 to 100	A `task_id`

Poll async jobs with GET /job-status/{task_id}, as shown in the quick start. See Credits & Pricing for costs.

Errors

For error responses (400, 403, 422, etc.), see Handling Errors.

Get Started

Intelligence API

Search API

Workflows API

Monitors API

Webhooks

Troubleshooting

Developer Tools

Request

Response

Async and bulk

Errors

​Request

​Response

​Async and bulk

​Errors

Request

Response

Async and bulk

Errors