Find working email via sequential SMTP pattern probing (x402-paid, $0.010 USDC)

SYNC inline SMTP find. No ARQ. No user context. Idempotent per candidate list.

Caller either pre-computes candidates or passes first/last/domain and we generate them. Returns the first pattern that SMTP-validates, or found=false if none did.

POST /api/x402/v1/email/find

Find working email via sequential SMTP pattern probing (x402-paid, $0.010 USDC)

cURL

curl --request POST \
  --url https://api.example.com/api/x402/v1/email/find \
  --header 'Content-Type: application/json' \
  --data '
{
  "candidates": [
    {}
  ],
  "first_name": "<string>",
  "last_name": "<string>",
  "domain": "<string>"
}
'

200

{
  "found": true,
  "backend": "<string>",
  "email": "<string>",
  "pattern": "<string>",
  "result": "<string>",
  "is_catch_all": true
}

Body

application/json

Request body for POST /api/x402/v1/email/find.

Agents either pass pre-computed candidates or pass first_name + last_name + domain and we generate canonical candidate patterns.

candidates · Candidates · object[] | null

Pre-computed candidate list [{email, pattern, confidence}, ...] sorted by confidence desc.

first_name · string | null

Maximum string length: 100

last_name · string | null

Maximum string length: 100

domain · string | null

Maximum string length: 253

Response

200

application/json

Successful Response

found · boolean · required

backend · string · required

email · string | null

pattern · string | null

result · string | null

is_catch_all · boolean | null