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

# Find from name

`POST /api/search/name`

Find someone's email from name and company (website or name). Uses one finder credit if a verified email is found.

## Request body

- object
  - `name` string, required — Person's full name
  - `domain` string, required — Company domain (best) or company name
  - `webhook_url` string — Webhook URL that will receive the result as callback. If submitted, email search will happen in the background and notify this URL upon completion.

## Response `200`

- union
  - object — Success
    - `contact` object
      - `name` string
      - `domain` string
      - `email` string
  - object — Webhook URL provided process asynchronous
    - `payload` object — (when using webhook_url) object POST method callback request triggered when webhook_url provided. See example response
      - `contact` object
        - `name` string
        - `email` string
        - `domain` string

## Other responses

- `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)