# Vaaya Icypeas Professional Email Search

> Vaaya Icypeas Professional Email Search is a paid API for AI agents from vaaya.ai, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-14).

Finds a person's professional email address from their name and company/domain via the Icypeas service, returning an async job ID to poll for results.

## Facts

- Endpoint: POST https://vaaya.ai/api/run/icypeas/email-search
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vaaya-icypeas-professional-email-search-83bbc7c8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_casFVx_aybKDMkWHYZPcm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vaaya-icypeas-professional-email-search-83bbc7c8 -d '<json body>'
```

Example prompt: Find the professional email address for Jane Doe who works at stripe.com — I need to reach out to her directly.

## When to prefer this

Use this endpoint when you need to find a specific individual's professional email address and you know their name and employer domain. It is particularly suited for B2B sales prospecting, recruiting outreach, or partnership contact discovery. Prefer this over general web search when you need a verified, graded email rather than a guessed format. Note the async nature requires a polling loop, so factor in latency for time-sensitive workflows.

## Known failure modes

- Invalid or missing domainOrCompany parameter returns an error
- Person not found in Icypeas database yields NOT_FOUND/DEBITED_NOT_FOUND status after polling
- Rate limit on polling endpoint (30 reads/min) if polled too aggressively
- Payment failure via x402 if insufficient USDC balance
- Async job may take multiple polling cycles to complete — premature reads return IN_PROGRESS
- Low certainty grade email returned that may be incorrect

## How this service works

Find a person's professional email via Icypeas from their name + company. Pass `firstname` and/or `lastname` plus `domainOrCompany` (domain preferred, e.g. stripe.com). Returns `{ item: { _id } }` immediately — the search runs async. KEEP POLLING icypeas/result with that `id` (every 3-5s; Icypeas caps reads at 30/min) until `status` leaves NONE/SCHEDULED/IN_PROGRESS. FOUND/DEBITED = hit, NOT_FOUND/DEBITED_NOT_FOUND = processed but empty. Results carry the email(s) with a certainty grade (ultra_…

## Output

Returns immediately with a job object containing an `_id` (search job ID). The agent must poll the icypeas/result endpoint every 3–5 seconds (max 30 reads/min) until `status` exits NONE/SCHEDULED/IN_PROGRESS. Final status FOUND/DEBITED means one or more emails were found with certainty grades (e.g. ultra_high, high); NOT_FOUND/DEBITED_NOT_FOUND means the search completed but no email was located.

## Request schema (JSON Schema)

```json
{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "input": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "enum": [
      "POST"
     ]
    },
    "bodyType": {
     "type": "string",
     "enum": [
      "json",
      "form-data",
      "text"
     ]
    },
    "body": {
     "type": "object",
     "properties": {
      "firstname": {
       "type": "string",
       "minLength": 1
      },
      "lastname": {
       "type": "string",
       "minLength": 1
      },
      "domainOrCompany": {
       "type": "string",
       "minLength": 2
      },
      "custom": {
       "type": "object",
       "properties": {
        "webhookUrl": {
         "type": "string",
         "format": "uri"
        },
        "externalId": {
         "type": "string",
         "minLength": 1,
         "maxLength": 200
        }
       },
       "additionalProperties": false
      }
     },
     "required": [
      "domainOrCompany"
     ],
     "additionalProperties": false,
     "$schema": "http://json-schema.org/draft-07/schema#"
    },
    "pathParams": {
     "type": "object"
    }
   },
   "required": [
    "type",
    "method",
    "bodyType",
    "body"
   ],
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   },
   "required": [
    "type"
   ]
  }
 },
 "required": [
  "input"
 ]
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vaaya-icypeas-professional-email-search-83bbc7c8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vaaya.ai](https://www.zero.xyz/host/vaaya.ai/llms.txt)