Runs examples for real against your account. Test keys only; kept in this tab, never stored on our side. Get a key
ZapSMTP / Docs / Email validation

Validate an address

POST/v1/email-validations

Check one address before you send to it: syntax, the domain and its mail servers, throw-away and role addresses, typos, your suppression list and earlier hard bounces.

Any API key; test keys too (nothing is sent or changed).

result: deliverable (every check passed), risky (it may arrive, but sending to it can hurt your reputation), undeliverable (it will bounce) or unknown (the domain's DNS did not answer: try again later).

reason is the most serious of reasons: invalid_syntax, reserved_domain, domain_not_found, no_mail_server, mailbox_not_found, previously_bounced (hard bounced on ZapSMTP in the last 180 days), dns_error, suppressed (on your suppression list), disposable, accept_all, role_address; ok when there is none.

checks.mailbox is exists, not_found, unknown or not_checked. Nothing is ever sent to the address. did_you_mean suggests a likely intended address when the domain looks like a typo.

Each address counts against your plan's monthly validations (Free 100, Pro 5,000, Scale 25,000); over it: 429 monthly_quota_exceeded. Results are not stored.

Body parameters

emailstringrequired
The address to check.

Errors

missing_required_fieldHTTP 422
email is required
monthly_quota_exceededHTTP 429
this month's validations of the plan are used up
rate_limit_exceededHTTP 429
email validation is limited to 120 requests per minute
POST/v1/email-validations
curl -X POST 'https://api.zapsmtp.com/v1/email-validations' \
  -H "Authorization: Bearer $ZAP_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "email": "ann@example.com"
}'
Set ZAP_API_KEY in your environment.
Response 200 OK
{
  "object": "email_validation",
  "email": "ann@example.com",
  "normalized": "ann@example.com",
  "result": "deliverable",
  "reason": "ok",
  "reasons": [],
  "score": 0.9,
  "did_you_mean": null,
  "checks": {
    "syntax": true,
    "domain": "example.com",
    "mx": [
      "mx1.example.com",
      "mx2.example.com"
    ],
    "disposable": false,
    "role": false,
    "free": false,
    "mailbox": "not_checked",
    "accept_all": null,
    "suppressed": false,
    "previously_bounced": false
  }
}