Skip to main content
POST
POST
Run a single email search to find a professional email address. Authenticate every request with your API key in the x-api-key header. For batch operations, use the Find Bulk Emails endpoint (up to 5,000 searches per batch). The search needs either:
  • A full name and a company: fullname + (company_domain or company_name)
  • The URL of a person’s LinkedIn profile in linkedin_url (see Search from a LinkedIn profile URL)
If both are present, the search runs on the name and the company.
Enrow performs determinist verifications that verify even catch-all emails. This means passing the found emails through a debouncer afterwards isn’t needed.

Request Body

string
The full name of the person for which to find the emailNote: Required for a name + company search, not for a search from linkedin_url.
string
The company’s domain, multiple formats accepted ("dundermifflin.com", "https://www.dundermifflin.com"…)Note: Either company_domain or company_name is required for a name + company search.
string
The company’s name ("Apple", "Air France", …)Note: Either company_domain or company_name is required for a name + company search.
string
The person’s LinkedIn profile URL ("https://www.linkedin.com/in/dwight-schrute"), to search from the profile instead of a name and a company. See Search from a LinkedIn profile URL.Note: Only used when the request is not a complete name + company search. With a fullname and a company, linkedin_url is ignored.
object
Custom params that will be returned in the GET response and in the webhook notification.
object
A set of settings related to this search

Response

200 — Search initiated

string
Confirmation message
string
Unique identifier for this search. Use this to retrieve results via the GET endpoint.
number
Number of credits consumed. See Credits & billing for per-endpoint costs.

Error Responses

Insufficient-credit (402) responses on single endpoints return { "reason": "...", "success": false }; all other errors return { "message": "..." }.
See Error handling for the full list of status codes and response formats.

Search from a LinkedIn profile URL

Send a person’s LinkedIn profile URL in linkedin_url instead of a full name and a company. Enrow reads the profile, identifies the person’s current company, then finds and verifies their professional email there. The search runs like any other single search: the 200 response gives you its id, and the result comes through the GET endpoint or your webhook. custom and settings work the same way.
Searching from a LinkedIn profile URL works for single searches only, and may not be available on every account. If your account doesn’t have it, a request with only a linkedin_url gets the usual validation error, such as missing fullname. Contact api@enrow.io if you need it.

When does the search use the profile?

The search runs from the profile when linkedin_url is given and the request is not a complete name + company search:
  • fullname is missing, blank or a single character, or
  • neither company_domain nor company_name is given.
A request with a fullname and a company stays a name + company search, even with a linkedin_url. When the search runs from the profile, the name and the company come from the profile: a fullname, company_domain or company_name sent along is ignored.

Which URLs are accepted?

Any other value is refused with a 400 and the message invalid linkedin_url format: a company page (linkedin.com/company/...), a short lnkd.in link, a page outside linkedin.com, or a profile name without the URL.

How does Enrow pick the company?

Enrow looks for the email at the person’s current company, as shown on the profile. When several positions are current, it takes the first one listed. Entries that are not an employer, such as self-employed, freelance or student, are skipped. A profile without a current position at an employer ends the search with no_current_company.

What does it cost?

Launching the search uses 1 credit, as for any search (credits_used: 1 in the response). Once it ends, the difference is refunded: the search costs 1 credit when an email is found, 0.25 credit when none is found, and nothing when it fails because of an issue on our side. The result gives the reason in linkedin_status and the final cost in credits_used. See Credits & billing.

Example

The response is the same as for a name + company search:

Next steps

Get the result

Retrieve the found email using the search id.

Find emails in bulk

Run up to 5,000 email searches in a single request.

Authentication

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

Webhooks

Get notified automatically when a search completes.