Email verification
Verify a single address in real time.
Verify an address
Verifies one email address and returns the result in the response. Each verification costs 5 credits, charged before the check runs. To verify many addresses at once, create a verification list. Requires an API key with full scope.
/email-verificationsRequest body
emailstringRequiredAddress to verify. A value that isn’t a valid address still returns 200, with result: "invalid" and a score of 0, and is charged.
modestringfast (default) checks syntax, disposable and role-based addresses, free providers, gibberish, MX records and domain age. full also connects to the recipient’s mail server to check whether the mailbox exists, is disabled or is full, and whether the domain accepts all addresses. Only full mode can confirm a mailbox. In fast mode, the mailbox checks are null. full can take up to about 40 seconds when a mail server is slow, so set your client timeout above that.
Returns
Returns 200 OK with an email_verification object. Emailit also sends an email_verification.created webhook event.
| Status | When |
|---|---|
400 |
email is missing or mode isn’t fast or full (standard validation error). |
402 |
The workspace doesn’t have 5 credits left. The body is {"error": {"message": "…", "code": 402}}. |
Result
result |
Meaning |
|---|---|
safe |
full: the mail server accepted the mailbox and rejected a made-up address on the same domain. fast: no check failed and the score is 70 or more; the mailbox wasn’t checked. |
role |
A role-based address such as info@ or support@. In full mode, the mailbox was confirmed too. |
catch_all |
The domain accepts mail for any address, so the mailbox can’t be confirmed. full mode only. |
unknown |
No clear answer: the mail server blocked or deferred the check, didn’t respond, or the DNS lookup failed. In fast mode, also when no check failed but the score is below 70. |
inbox_full |
The mailbox is full. full mode only. |
disabled |
The mailbox exists but is disabled. full mode only. |
disposable |
The domain belongs to a disposable email service. |
invalid |
The syntax is invalid, the domain has no MX records, or the mail server said the mailbox doesn’t exist. |
The order Emailit applies them in is in Verification results.
Score and risk
score runs from 0 to 100; addresses that can’t receive mail score 0. risk is high for invalid, disabled and disposable, and medium for catch_all, inbox_full and unknown (high if their score is below 50). For safe and role it follows the score: low from 80, medium from 50, and high below 50. See Score.
Fields
statusstringcompleted for single verifications.
checksobjectIndividual checks: valid_syntax, disposable, role_account, free_email and gibberish (booleans), has_mx_records (boolean, or null if the DNS lookup failed), domain_age (age of the domain in days, or null if unknown), and the full-mode checks smtp_connect, deliverable, disabled, inbox_full and catch_all (null in fast mode, and in full mode when the mail server gave no clear answer).
addressobjectThe address split into mailbox, domain, suffix (the part after +, or null) and root (the address without the suffix).
did_you_meanstring | nullSuggested correction for a likely typo, for example ada@gmail.com for ada@gmial.com.
mx_recordsobject[]The domain’s MX records, each with priority and exchange.
{
"id": "ev_2xLd4Wq8Bn1Ys6Pk3Rm9Tc0Fh5a",
"object": "email_verification",
"email": "ada@example.com",
"status": "completed",
"score": 100,
"risk": "low",
"result": "safe",
"mode": "fast",
"checks": {
"valid_syntax": true,
"disposable": false,
"role_account": false,
"inbox_full": null,
"deliverable": null,
"disabled": null,
"catch_all": null,
"free_email": false,
"smtp_connect": null,
"has_mx_records": true,
"domain_age": 10957,
"gibberish": false
},
"address": {
"mailbox": "ada",
"domain": "example.com",
"suffix": null,
"root": "ada@example.com"
},
"did_you_mean": null,
"mx_records": [
{ "priority": 10, "exchange": "mx1.example.com" }
],
"created_at": "2026-10-01T10:20:31.118000+00:00",
"updated_at": "2026-10-01T10:20:31.118000+00:00"
}{
"error": {
"message": "Workspace has insufficient email credits for email verification. Each verification requires 5 credits.",
"code": 402
}
}