Verify Single Email
Verify a single email address in real-time to check its deliverability and validity.
POST
/email-verificationsRequest Body
emailstringRequiredEmail address to verify.
modestringVerification mode: fast or full. Default: full. Fast mode skips some SMTP checks and returns null for certain fields.
{
"id": "ev_abc123xyz",
"email": "user@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "full",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": false,
"deliverable": true,
"disabled": false,
"free_email": false,
"gibberish": false,
"catch_all": false,
"smtp_connect": true,
"has_mx_records": true,
"domain_age": 5840
},
"address": {
"mailbox": "user",
"domain": "example.com",
"suffix": null,
"root": "user@example.com"
},
"did_you_mean": null,
"mx_records": [
{
"priority": 10,
"exchange": "mail.example.com"
}
]
} {
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid email format"
} {
"statusCode": 402,
"error": "Payment Required",
"message": "Insufficient credits for email verification"
} Response Fields
Verification Status
| Value | Description |
|---|---|
| pending | Verification queued but not started |
| processing | Verification in progress |
| completed | Verification finished successfully |
| failed | Verification failed due to an error |
Verification Result
| Value | Description |
|---|---|
| safe | Email is valid and deliverable |
| invalid | Email is invalid (syntax, domain, or mailbox) |
| disposable | Email uses a disposable/temporary domain |
| disabled | Mailbox exists but is disabled |
| inbox_full | Mailbox is full and cannot receive emails |
| unknown | Could not determine deliverability |
Risk Level
| Value | Score Range | Description |
|---|---|---|
| low | 80-100 | Safe to send |
| medium | 50-79 | Use caution |
| high | 0-49 | High bounce risk |
Checks Object
| Field | Type | Description |
|---|---|---|
| valid_syntax | boolean | Email syntax is valid |
| disposable | boolean | Uses disposable domain |
| role_account | boolean | Role-based address (info@, support@) |
| inbox_full | boolean/null | Mailbox is full |
| deliverable | boolean/null | Email is deliverable |
| disabled | boolean/null | Mailbox is disabled |
| free_email | boolean | Uses free email provider |
| gibberish | boolean | Mailbox appears to be gibberish |
| catch_all | boolean/null | Domain accepts all emails |
| smtp_connect | boolean/null | SMTP connection successful |
| has_mx_records | boolean | Domain has MX records |
| domain_age | integer/null | Domain age in days |
Note: Fields marked as boolean/null or integer/null may return null in fast mode.