POST /v1/find_email

Family: Verification and finder · Operation ID: v1_find_email

Access

Workspace API key: Authorization: Bearer <key>. The key is scoped to its workspace; the backend checks operation permissions and quota.

Open finder

Required scope: find

Create a key in Developer settings. Set API_BASE_URL to the current app origin.

Request example

curl --fail-with-body -X POST "$API_BASE_URL/v1/find_email" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

Request body · application/json

{
  "$ref": "#/components/schemas/FindEmailRequest",
  "definition": {
    "properties": {
      "domain": {
        "type": "string"
      },
      "first_name": {
        "type": "string"
      },
      "last_name": {
        "type": "string"
      },
      "strategy": {
        "default": "parallel",
        "description": "Search strategy: parallel (all at once) or waterfall (high-quality patterns first)",
        "enum": [
          "parallel",
          "waterfall"
        ],
        "type": "string"
      }
    },
    "required": [
      "first_name",
      "last_name",
      "domain"
    ],
    "type": "object"
  }
}

Responses

202

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/FindEmailAcceptedResponse"
      }
    }
  },
  "description": "Finder job accepted"
}

default

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract