Email Verify
$0.01per callemail.verifyVerify email deliverability and quality
Endpoint
POST /v1/tools/email.verify/tasksInput
| Field | Type | Required | Description |
|---|---|---|---|
| string | yes | Email address to verify |
Output
| Field | Type | Description |
|---|---|---|
| string | The email address that was verified | |
| deliverable | boolean | Whether the email is deliverable |
| status | string | Deliverability status (DELIVERABLE, UNDELIVERABLE, RISKY, UNKNOWN) |
| status_detail | string | Additional detail about the status |
| quality_score | number | Quality score from 0 to 1 |
| is_format_valid | boolean | Whether the email format is valid |
| is_smtp_valid | boolean | Whether SMTP validation passed |
| is_mx_valid | boolean | Whether MX records exist for the domain |
| mx_records | array | List of MX records found |
| is_disposable | boolean | Whether from a disposable email provider |
| is_free_email | boolean | Whether from a free provider (Gmail, Yahoo, etc.) |
| is_role_based | boolean | Whether role-based (info@, support@, etc.) |
| is_catchall | boolean | Whether the domain is a catch-all |
Example
Request
{
"email": "test@gmail.com"
}Response
{
"email": "test@gmail.com",
"deliverable": true,
"status": "DELIVERABLE",
"status_detail": null,
"quality_score": 0.95,
"is_format_valid": true,
"is_smtp_valid": true,
"is_mx_valid": true,
"mx_records": [
"gmail-smtp-in.l.google.com"
],
"is_disposable": false,
"is_free_email": true,
"is_role_based": false,
"is_catchall": false
}