Find a Person's Email

Use this endpoint to find a person's email by providing their name and company details (domain or company name). It uses advanced algorithms and SMTP verification to deliver accurate, privacy-compliant results.

Endpoint

POST

https://api.anymailfinder.com
/v5.1/find-email/person

Pricing

1 credit: charged only when a valid email is found.
Free: if the result is risky, blacklisted, or not found.
Repeated searches within the past 30 days are free.

Authentication

Include your API key using the Authorization header.
Refer to the Authentication page for setup instructions.

Performance

Timeout recommendation: 180 seconds.
Searches are performed in real time. Response times depend on factors like the company's SMTP server, website responsiveness, and advanced operations to uncover catch-all emails.
No Rate Limits.
Our system efficiently auto-scales to handle high volumes of requests.

Code example

curl -X POST "https://api.anymailfinder.com/v5.1/find-email/person" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domain": "microsoft.com",
    "full_name": "John Doe"
  }'

Request parameters

Send as JSON in the POST body:

Parameter	Example value	Description
`domain` string - optional	`"microsoft.com"`	Preferred. The company's domain. If a company name is passed here, we'll attempt to find the domain.
`company_name` string - optional	`"Microsoft"`	The company name. If a domain is passed here, we'll detect and treat it accordingly.
`first_name` string - optional	`"John"`	First name of the person.
`last_name` string - optional	`"Doe"`	Last name of the person.
`full_name` string - optional	`"John Doe"`	Alternative to first+last name.

Notes:

At least one of full_name or both first_name and last_name must be provided.
At least one of domain or company_name must be provided.
If domain is available, it is preferred - it more reliably leads to accurate results.

Headers

Parameter	Example value	Description
`x-webhook-url` string - optional	`"https://yourdomain.com/webhook"`	If provided, the result will be POSTed to this URL instead of waiting for the response.

Response

200OK

Without webhook: The request responds once the search completes, returning the full result below.
With webhook: The request returns immediately with 200 OK, and the result will be sent to the specified x-webhook-url via POST.

{
  "email": "john.doe@microsoft.com",
  "email_status": "valid"
}

Property Type Description

email string | null The email found, or null if not found.

email_status

string

The email status. One of the following:

`valid`	The email is deliverable and verified. More info
`risky`	The email may exist, but verification is inconclusive. More info
`not_found`	No email could be found for this person. More info
`blacklisted`	This email or domain is blocked due to a request or policy restriction.

Risky emails might bounce. They're provided for free. Use only valid emails to protect your sender reputation. More info

Note: The original input is also returned in the response under the input field. This can help with debugging or automating workflows in no-code tools.

400Bad Request

401Unauthorized

402Payment Needed

Need Help?

Our team is experienced with APIs and is here to help. Contact us via chat or email at team@anymailfinder.com.