Skip to content
MailVet
Updated November 13, 2026

Verify an email

GET /v1/verify checks one address in real time: syntax, domain, mailbox and catch-all status. Most calls return within a few seconds.

Request

ParameterTypeDescription
emailstring, requiredThe address to verify. URL-encode it.
timeoutinteger, optionalSeconds to wait before returning pending, 3 to 15. Default 15.
webhook_urlstring, optionalSend the result here too. Overrides the account default for this call.

Response

HTTP 200 when the check finished inside the timeout.

200 OK
{
  "id": "vrf_01JD8X2T7Q",
  "email": "dana.reyes@northwind.example",
  "status": "done",
  "result": "deliverable",
  "reason": "catch_all_verified",
  "score": 94,
  "domain": "northwind.example",
  "mx": "aspmx.l.google.com",
  "flags": {
    "catch_all_domain": true,
    "disposable": false,
    "role": false,
    "free_provider": false
  },
  "credits_charged": 1,
  "took_ms": 2140
}

Response fields

FieldTypeDescription
idstringVerification id, vrf_…. Use it to fetch the result again.
statusstringdone or pending.
resultstringdeliverable, undeliverable, risky or unknown. Null while pending.
reasonstringWhy this result. Full list below and on /email-verification-statuses.
scoreinteger0–100 confidence that mail to this address will be delivered.
domain / mxstringThe address's domain and its primary mail server.
flagsobjectcatch_all_domain, disposable, role, free_provider, all booleans.
credits_chargedinteger1 for a definite result, 0 for unknown, pending or invalid syntax.
took_msintegerTime we spent on the check, in milliseconds.

Result and reason codes

ResultReason codeWhat it meansWhat to doCredit
deliverableacceptedThe mail server confirmed the mailbox exists and accepts mail.Send.1 credit
deliverablecatch_all_verifiedThe domain accepts all mail, and we confirmed this specific mailbox is real.Send. Most verifiers would have marked this "unknown".1 credit
undeliverablemailbox_not_foundThe server rejected the address: no such mailbox.Remove it. Sending will hard-bounce.1 credit
undeliverablecatch_all_no_mailboxThe domain accepts all mail, but there is no real person behind this address.Remove it. It would be accepted, then lost or bounced later.1 credit
undeliverableinvalid_domainThe domain doesn't exist or has no mail (MX) records.Remove it, or fix a typo like gmial.com.1 credit
undeliverableinvalid_syntaxNot a valid email address format.Remove it. We catch these before any check runs.Free
riskydisposableA temporary inbox from a throwaway-email provider.Block on signup forms; don't send campaigns.1 credit
riskymailbox_fullThe mailbox exists but is over quota and refusing new mail.Hold and retry later; often an abandoned inbox.1 credit
unknownno_responseThe mail server timed out or kept greylisting us.Re-run later. Don't send yet.Free
unknowncatch_all_unresolvedA catch-all domain where we couldn't reach a confident verdict.Re-run later, or send only from a separate, warmed domain.Free

Pending checks

If the check needs longer than timeout, the API returns HTTP 202 with status: "pending", result: null and a poll_url. Fetch GET /v1/verify/{id} until status is done, or receive the verification.completed webhook. No credit is used until the check finishes with a definite result.