find-email

Search for a decision maker email based on company and category.

Find the details and emails of a decision maker of a specific category at a company. This search requires either "company_name" or "domain" to identify the company, and the "decision_maker_category".

post/v5.1/find-email/decision-maker

Request

  • Base URL: https://api.anymailfinder.com
  • URL: https://api.anymailfinder.com/v5.1/find-email/decision-maker
  • Auth: API key in header Authorization

Headers

x-webhook-urlstring

If provided, the result will be POSTed to this URL instead of waiting for the response.

Request body

company_namestring

Used if domain is not provided.

decision_maker_categorystring[] required

The category of the decision maker to search for. One or more of the following: "ceo", "engineering", "finance", "hr", "it", "logistics", "marketing", "operations", "buyer", "sales".

domainstring

Preferred. The company domain.

Response

Email found.

inputobject required

Your request original input.

credits_chargednumber required

Number of credits charged for this request.

decision_maker_categorystring nullable required

The decision maker category that matched, or null if not found.

emailstring nullable required

The email found, or null if not found.

email_status'valid' | 'not_found' | 'blacklisted' required

The email status. One of the following: valid, not_found, blacklisted.

mx_domainstring nullable required

The root domain of the MX hostname, e.g. google.com or outlook.com. null when mx_host is null.

mx_hoststring nullable required

The domain's primary MX hostname, or null if no email was found.

person_first_namestring nullable required

The decision maker's first (given) name. Null when the full name could not be confidently split into first and last name.

person_full_namestring nullable required

The full name of the decision maker.

person_job_titlestring nullable required

The job title of the decision maker.

person_last_namestring nullable required

The decision maker's last (family) name. Null when the full name could not be confidently split into first and last name.

person_linkedin_urlstring nullable required

The LinkedIn profile URL of the decision maker, if available.

valid_emailstring nullable required

The email only when email_status is valid. Otherwise null.

Example response

{
  "decision_maker_category": "ceo",
  "email": "satyan@microsoft.com",
  "email_status": "valid",
  "mx_domain": "google.com",
  "mx_host": "aspmx.l.google.com",
  "person_first_name": "Satya",
  "person_full_name": "Satya Nadella",
  "person_job_title": "Chairman and CEO",
  "person_last_name": "Nadella",
  "person_linkedin_url": "https://www.linkedin.com/in/satyanadella/",
  "valid_email": "satyan@microsoft.com"
}

Changes

No recorded changes to this operation across all 1 revision of this API.