---
title: "Instant Email Finder"
method: POST
path: "/email_finder/instant"
tags: ["Email Finder"]
---

# Instant Email Finder

`POST /email_finder/instant`

Instantly discover email address of any person giving their name and domain or company name

## Request body

- object
  - `name` string, required — Name of the person (eg:- Mr. Tony Stark or Robert Downey Jr.)
  - `domain` string, required — Domain or Company name (eg:- marvel.com or Marvel Entertainment Company)
  - `timeout` integer — Request wait time (in milliseconds)
  - `queue` boolean — Flag to indicate whether email discovery can be performed in background even after the request timed out, this will help to retrieve result later using queue id or downloaded from Clearout App -> My Activities. Setting 'false' will stop the email discovery immediately when timeout occured

## Response `200`

OK

- union
  - InstantEmailFinderSuccessResponseType
    - `status` string
    - `data` object
      - `emails` object[]
        - `email_address` string
        - `role` string
        - `business` string
      - `first_name` string
      - `last_name` string
      - `full_name` string
      - `domain` string
      - `confidence_score` integer
      - `total` integer
      - `company` object
        - `name` string
      - `found_on` string
  - InstantEmailFinderFailureResponseType
    - `status` string
    - `error` object
      - `code` integer
      - `message` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required
- `429` — Too Many Requests
- `503` — Service Unavailable
- `524` — A Timeout Occurred

---

[API](https://skmtc.dev/clearout/apis/clearout-openapi.md) · [All operations](https://skmtc.dev/clearout/apis/clearout-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clearout/clearout-openapi/revisions/e9bdd90a5e76/schema)
