Validate email deliverability
validate_emailCheck deliverability for email addresses you already have, so you can avoid bounced sends; each submitted address is billed.
Instructions
Check deliverability of emails you already have. BILLABLE — about $0.005 per email submitted — every address is billed, whatever the verdict (Tier 0 list price; your account may pay a different rate — call get_balance for your real prices, and read cost.amount_charged in every response for what was actually spent). This is the one operation where EVERY submitted address is billed — the verdict is the deliverable. Never validate an address that generate_email just returned as valid; it is already verified.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| emails | Yes | Email addresses to validate. Each one is billed. | |
| timeout_ms | No | Request timeout in milliseconds. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| results | No | ||
| submitted | No | ||
| test_mode | No | ||
| test_mode_notice | No | ||
| vocabulary_warnings | No | ||
| deprecated_params_ignored | No |