Find Company Emails
Use this endpoint to retrieve up to 20 email addresses associated with a company by providing a domain or company name. It leverages advanced algorithms and real-time verification to uncover accurate, privacy-compliant results.
Endpoint
https://api.anymailfinder.com
/v5.1/find-email/companyPricing
- 1 credit: charged only when valid emails are found, including up to 20 results per request.
- Free: if no emails are found or the result is blacklisted.
- 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/company" \-H "Authorization: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"domain": "microsoft.com"}'
Request parameters
Send as JSON in the POST body:
| Parameter | Example value | Description | ||||||
|---|---|---|---|---|---|---|---|---|
domainstring - optional | "microsoft.com" | Preferred. The company's domain. If a company name is passed here, we'll attempt to find the domain. | ||||||
company_namestring - optional | "Microsoft" | The company name. If a domain is passed here, we'll detect and treat it accordingly. | ||||||
email_typestring - optional | "any" | Specifies which type of email addresses to return:
|
- At least one of
domainorcompany_namemust be provided. - If
domainis available, it is preferred - it more reliably leads to accurate results.
Headers
| Parameter | Example value | Description |
|---|---|---|
x-webhook-urlstring - 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-urlvia POST.
{"credits_charged": 1,"email_status": "valid","emails": ["susan.smith@microsoft.com","john.doe@microsoft.com","jane.johnson@microsoft.com","michael.brown@microsoft.com","linda.white@microsoft.com","robert.davis@microsoft.com","karen.martin@microsoft.com","david.jackson@microsoft.com","patricia.clark@microsoft.com","james.robinson@microsoft.com","elizabeth.moore@microsoft.com","christopher.wilson@microsoft.com","mary.taylor@microsoft.com","daniel.anderson@microsoft.com","nancy.thomas@microsoft.com","thomas.thompson@microsoft.com","laura.hall@microsoft.com","joshua.wright@microsoft.com","emily.harris@microsoft.com","sarah.lewis@microsoft.com"],"mx_domain": "outlook.com","mx_host": "microsoft-com.mail.protection.outlook.com","valid_emails": ["susan.smith@microsoft.com","john.doe@microsoft.com","jane.johnson@microsoft.com","michael.brown@microsoft.com","linda.white@microsoft.com","robert.davis@microsoft.com","karen.martin@microsoft.com","david.jackson@microsoft.com","patricia.clark@microsoft.com","james.robinson@microsoft.com","elizabeth.moore@microsoft.com","christopher.wilson@microsoft.com","mary.taylor@microsoft.com","daniel.anderson@microsoft.com","nancy.thomas@microsoft.com","thomas.thompson@microsoft.com","laura.hall@microsoft.com","joshua.wright@microsoft.com","emily.harris@microsoft.com","sarah.lewis@microsoft.com"]}
| Property | Type | Description | ||||||
|---|---|---|---|---|---|---|---|---|
credits_charged | number | Number of credits charged for this request. | ||||||
email_status | string | The email status. One of the following:
not_found instead. Nothing else in the response changes. Risky emails were never charged, so billing is unaffected. The verify-email endpoint keeps the risky status. Learn about email verification statuses | ||||||
emails | string[] | An array containing up to 20 email addresses found for the specified company.Tip: if you want only valid emails, use valid_emails. | ||||||
mx_domain | string | null | The root domain of the MX hostname, e.g. google.com or outlook.com. null when mx_host is null. | ||||||
mx_host | string | null | The domain's primary MX hostname, or null if no email was found. | ||||||
valid_emails | string[] | An array containing up to 20 email addresses found for the company, only when email_status is valid. Otherwise, this array is empty. |
400Bad Request
The request is missing required data or is improperly formatted.
Review the message field to identify and correct the issue.
{"error": "bad_request","message": "..."}
401Unauthorized
The request did not include a valid API key. If no key was sent at all, the message tells you to add the Authorization header instead.
Refer to the Authentication page to ensure your API key is properly included.
{"error": "unauthorized","message": "Invalid API key. Copy it again from https://app.anymailfinder.com/settings/api (if you regenerated it, use the new one)."}
402Payment Needed
Your account does not have enough credits to complete this request.
You can purchase additional credits to continue.
{"error": "upgrade_needed","message": "Your account does not have enough credits. Purchase more at https://app.anymailfinder.com/purchase."}
Need Help?
Our team is experienced with APIs and is here to help.
Chat with us.