Email Verification API

Overview

This email verification API tells you whether an address can receive mail before you send to it. Every verification runs the full stack: syntax validation, MX resolution, a live SMTP handshake against the recipient's mail server, disposable-domain and role-account detection, and — where the domain accepts everything — our proprietary resolution engine that sees straight through accept-all domains and resolves catch-all addresses other APIs return as "risky".

Every response carries one of four statuses:

Alongside the status you get a machine-readable reason plus boolean flags — is_catch_all, is_disposable, is_role_based, is_free_provider — so your application can apply its own policy (for example: send to deliverable, suppress role accounts, queue risky for review).

Quickstart

Grab a key from the dashboard, then verify your first address. Base URL: https://api.emailverificationapi.io/v1

curl https://api.emailverificationapi.io/v1/verify \
  -H "X-API-Key: ev_live_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"email": "jane@acme.com"}'

const res = await fetch('https://api.emailverificationapi.io/v1/verify', {
  method: 'POST',
  headers: {
    'X-API-Key': process.env.EVAPI_KEY,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ email: 'jane@acme.com' }),
});
const data = await res.json();
console.log(data.status); // "deliverable"

import os, requests

res = requests.post(
    "https://api.emailverificationapi.io/v1/verify",
    headers={"X-API-Key": os.environ["EVAPI_KEY"]},
    json={"email": "jane@acme.com"},
)
print(res.json()["status"])  # "deliverable"

Response 200

{
  "email": "jane@acme.com",
  "status": "deliverable",
  "reason": "deliverable",
  "is_catch_all": false,
  "is_disposable": false,
  "is_role_based": false,
  "is_free_provider": false,
  "duration_ms": 2840,
  "credits_used": 1,
  "credits_remaining": 4999
}

SMTP handshakes run live, so a verification typically takes 1–10 seconds; slow or greylisting servers can take up to 30. Set client timeouts accordingly.

Authentication

Authenticate every request with your secret key in the X-API-Key header. Keys are created and rotated from the dashboard; live keys are prefixed ev_live_. Keep keys server-side — never ship them in browser or mobile code.

X-API-Key: ev_live_xxxxxxxxxxxx

Requests without a valid key return 401; requests exceeding your rate limit return 429 with a Retry-After header.

Endpoints

{ "email": "jane@acme.com" }

{
  "email": "jane@acme.com",
  "status": "deliverable",
  "reason": "deliverable",
  "is_catch_all": false,
  "is_disposable": false,
  "is_role_based": false,
  "is_free_provider": false,
  "duration_ms": 2840,
  "credits_used": 1,
  "credits_remaining": 4999
}

{ "emails": ["jane@acme.com", "ops@firma.de", "noreply@store.io"] }

{
  "id": "job_9f2c81d4",
  "status": "queued",
  "total_emails": 18452,
  "credits_charged": 18452
}

{
  "id": "job_9f2c81d4",
  "status": "processing",
  "total_emails": 18452,
  "processed": 11210,
  "counts": {
    "deliverable": 8473,
    "undeliverable": 1675,
    "risky": 588,
    "unknown": 474
  }
}

email,status,reason,is_catch_all,is_disposable,is_role_based,is_free_provider
jane@acme.com,deliverable,deliverable,false,false,false,false
ops@firma.de,deliverable,deliverable,true,false,true,false
ghost@oldcorp.com,undeliverable,undeliverable,false,false,false,false

{ "balance": 4999 }

Rate limits & credits

Every key is limited to 120 requests per minute. Exceeding it returns 429 with a Retry-After header — back off and retry. For high-volume cleaning, prefer one bulk job over thousands of single calls: a 50,000-row job is one request.

Billing is strictly per result: 1 credit = 1 verification. unknown results are never charged on single verifications and are refunded automatically on bulk jobs, so you only ever pay for answers.

Pricing

Start with 100 free API credits — no card required. Pay-as-you-go: buy credits in packs, top up any time, and credits never expire. Credits work across single, bulk and API verification.

Unknown verdicts are not billed — never charged on single checks and refunded automatically on bulk jobs.

FAQ