---
title: "Find from domain"
method: POST
path: "/api/search/domain"
tags: ["Email Finder"]
---

# Find from domain

`POST /api/search/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>

## Request body

- object
  - `domain` string, required — Email domain
  - `roles` string[], required — Target roles related to the given domain (max 3 roles)
  - `webhook_url` string — Webhook URL that will receive the result as callback. If submitted, search will happen in the background and notify this URL upon completion.

## Response `200`

- object
  - `contacts` object[]
    - `domain` string
    - `email` string
    - `name` string

## Other responses

- `0` — Webhook URL provided process asynchronous
- `402` — Error : Not enough credits
- `423` — Error : Subscription is paused

---

[API](https://skmtc.net/findymail/apis/findymail-api-documentation.md) · [All operations](https://skmtc.net/findymail/apis/findymail-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/findymail/findymail-api-documentation/revisions/ae7fddf16bf9/schema)