Email Finder

Find an email

Find and verify the email address of one person from their first name, last name and company. The call is synchronous: the address and its deliverability verdict come back in the response.

Slow lookups: if the lookup is still running after about 25 seconds you get 202 with a job_id instead. The lookup carries on and is billed the same way; poll GET /v1/email-finder/{job_id}/ for the result.

Company information: supply company_name or company_domain — at least one is needed, and giving both finds the right address more often.

A person we cannot find an address for is not an error: the response still arrives with prospect.status set to failed, prospect.found_email null, and the reason in prospect.error_message.

Cost: 1 credit when a deliverable email is found, nothing when it is not. Use POST /v1/email-finder/ instead when you have more than a handful of people to look up.

post/v1/email-finder/single/

Request

  • Base URL: https://api.evaboot.com
  • URL: https://api.evaboot.com/v1/email-finder/single/
  • Auth: HTTP bearer

Request body

first_namestring required

First name of the person whose email you are looking for.

last_namestring required

Last name of the person whose email you are looking for.

company_namestring

Name of the company the person works at. Supply this or company_domain — the lookup needs at least one of them, and sending both gives the best hit rate.

company_domainstring

Web domain of the company, without a scheme or path. The most accurate way to identify the company; supply this or company_name.

Example request

{
  "first_name": "John",
  "last_name": "Doe",
  "company_name": "Example Corp",
  "company_domain": "example.com"
}

Response

OK

successboolean

true when the lookup ran, including when it ran and found nothing; false when the lookup itself errored.

job_idstring

Reference for this single lookup. There is nothing to poll: the result is already in prospect.

Example response

{
  "success": true,
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "prospect": {
    "id": "5371cd59-adc2-402f-af02-d40aee34f629",
    "first_name": "John",
    "last_name": "Doe",
    "full_name": "John Doe",
    "company_name": "Example Corp",
    "company_domain": "example.com",
    "found_email": "john.doe@example.com",
    "email_validity": "safe",
    "status": "complete",
    "error_message": "Email not found"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.