Find a Decision Maker's Email

Use this endpoint to find the email address and details of a decision maker in a specific category at a company. Provide either the domain or company name, along with the decision maker category. Advanced 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:

ParameterExample valueDescription
decision_maker_category
string
"ceo"The category of the decision maker to search for. One of the following:
ValueSearch for
ceoCEO / Owner / President / Founder
engineeringEngineering
financeFinance
hrHuman Resources (HR)
itIT (Information Technology)
logisticsLogistics
marketingMarketing
operationsOperations / Administration
buyerProcurement (Buyer)
salesSales
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

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": "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/"
}
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
person_full_namestring | nullThe full name of the decision maker.
person_job_titlestring | nullThe job title of the decision maker.
person_linkedin_urlstring | nullThe 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.