Validate email deliverability
validate_emailCheck deliverability of existing email addresses before sending. Each submitted address is billed and returns a deliverability verdict.
Instructions
Check deliverability of emails you already have. Billable: about $0.005 per email submitted (every address is billed, whatever the verdict) at the Tier 0 list price. Accounts can pay a different rate: get_balance returns this account's prices, and every response reports what was actually spent in cost.amount_charged_usd. This is the one operation where every submitted address is billed: the verdict is the deliverable. An address generate_email returned as valid is already verified, so validating it again only adds cost.
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 |