Find a Decision Maker's Email

Use this endpoint to find the email address and details of a decision maker in one or more specified categories at a company. Provide either the domain (preferred) or company name, along with one or more decision maker categories. Our algorithms and verification ensure accurate, privacy-compliant results.

Endpoint

POST

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

Pricing

2 credits: 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/decision-maker" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "microsoft.com", "decision_maker_category": ["ceo"]}'

Request parameters

Send as JSON in the POST body:

Parameter Example value Description

decision_maker_category
string[]

[
  "finance",
  "ceo"
]

One or more categories of the decision maker(s) to search for. If multiple are provided, they are treated in order of importance and we will return the first category that resolves to a valid email.

Value	Search for
`ceo`	CEO / Owner / President / Founder
`engineering`	Engineering
`finance`	Finance
`hr`	Human Resources (HR)
`it`	IT (Information Technology)
`logistics`	Logistics
`marketing`	Marketing
`operations`	Operations / Administration
`buyer`	Procurement (Buyer)
`sales`	Sales

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.

Notes:

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": "satyan@microsoft.com",
  "email_status": "valid",
  "person_full_name": "Satya Nadella",
  "person_job_title": "Chairman and CEO",
  "person_linkedin_url": "https://www.linkedin.com/in/satyanadella/"
}

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.
`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

person_full_name string | null The full name of the decision maker.

person_job_title string | null The job title of the decision maker.

person_linkedin_url string | null The LinkedIn profile URL of the decision maker, if available.

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.