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: Bearer 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:

ParameterExample valueDescription
domain
string - optional
"microsoft.com"Preferred. The company domain.
company_name
string - optional
"Microsoft"Used if domain is not provided.
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 domain or company_name is required, but you may provide both.
  • domain is preferred as using company_name may not always yield the correct domain.
  • You must provide either full_name or both first_name and last_name.

Headers

ParameterExample valueDescription
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"
}
PropertyTypeDescription
emailstring | nullThe email found, or null if not found.
email_statusstringThe email status. One of the following:
validThe email is deliverable and verified. More info
riskyThe email may exist, but verification is inconclusive. More info
not_foundNo email could be found for this person. More info
blacklistedThis 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.