Skip to content
Docs

Verify a single address in real time.

Base URLhttps://api.emailit.com/v2AuthenticationErrorsRate limits

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.

POST/email-verifications

Request body

emailstringRequired

Address to verify. A value that isn’t a valid address still returns 200, with result: "invalid" and a score of 0, and is charged.

modestring

fast (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

statusstring

completed for single verifications.

checksobject

Individual 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).

addressobject

The address split into mailbox, domain, suffix (the part after +, or null) and root (the address without the suffix).

did_you_meanstring | null

Suggested 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.

POST/email-verifications
Terminal
curl -X POST https://api.emailit.com/v2/email-verifications \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "ada@example.com"}'
JSON
{
  "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"
}

Was this page helpful?

Thanks for the feedback.

Thanks, we read every message.