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
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:
Parameter | Example value | Description |
---|---|---|
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. |
- At least one of
domain
orcompany_name
is required, but you may provide both. domain
is preferred as usingcompany_name
may not always yield the correct domain.- You must provide either
full_name
or bothfirst_name
andlast_name
.
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
- 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:
|
Need Help?
Our team is experienced with APIs and is here to help. Contact us via chat or email at team@anymailfinder.com.