latestOpenAPI 3.0.32026-08-08360156.4 KB

ae7fddf16bf9

Email Finder

Find from domain

Try finding a contact with a valid email at a given domain with a given role. A contact is only returned if we found a valid email.

Due to the heavy processing involved (real-time search), this endpoint is limited to 5 concurrent requests (when used synchronously) and async jobs can take up to 24 hours to be processed depending on our workload (usually sooner).

<aside class="notice">DEPRECATED: This endpoint is no longer recommended for production usage. Please use <a href="https://app.findymail.com/docs/#misc-POSTapi-search-employees">Find Employees</a> endpoint instead</aside>
post/api/search/domain

Request body

domainstring required

Email domain

rolesstring[] required

Target roles related to the given domain (max 3 roles)

webhook_urlstring

Webhook URL that will receive the result as callback. If submitted, search will happen in the background and notify this URL upon completion.

Example request

{
  "domain": "domain.com",
  "roles": [
    "CEO",
    "Founder"
  ],
  "webhook_url": "http://collins.com/quia-ex-facilis-corporis-voluptate"
}

Response

Example response

{
  "contacts": [
    {
      "domain": "website.com",
      "email": "john@website.com",
      "name": "john doe"
    }
  ]
}