Email validation API

Stop fake signups before
they reach your database.

One API call tells you whether an address is disposable, temporary or undeliverable. It catches domains that went live this morning, not just the ones on public lists.

Try:
109,000+known disposable domains, refreshed daily
MX fingerprintsflag new burner domains on shared mail servers
Relay-awareApple Hide My Email and Firefox Relay stay allowed
How it works

Five public lists plus our own detection engine.

Public lists miss new domains and wrongly flag real ones. We merge them, then check each domain's mail servers ourselves.

1 · Weighted lists

Five open-source lists are merged every day. Each one is weighted by how often it falsely flags popular domains, so a single noisy list can't block a university.

2 · Mail-server fingerprints

Burner services reuse the same mail servers across thousands of domains. We map those servers, so a domain registered an hour ago still gets caught.

3 · Deliverability

Domains that don't exist, have no MX record or publish a null MX come back as undeliverable. Spelling-based signals are capped, so they never block anyone on their own.

Pricing

Start free. Upgrade when it pays for itself.

Every plan has the full detection engine. Only successful checks count toward your quota, and you can change or cancel your plan any time.

Get an API key

Your key in under a minute.

No card needed for the free plan. Already have an account? Enter the same email to get a new key.

Your API key. Copy it now. We only store a hash, so it can't be shown again.

Open your dashboard →

Documentation

API reference

Authentication

Send your key as a bearer token. The base URL is https://api.burnerapi.com.

Authorization: Bearer dea_live_…

Check one address

GET /v1/check?email=… or GET /v1/check?domain=…. Costs 1 unit.

curl "https://api.burnerapi.com/v1/check?email=user@mailinator.com" \
  -H "Authorization: Bearer $DEA_KEY"

Response:

{
  "input": "user@mailinator.com",
  "domain": "mailinator.com",
  "verdict": "disposable",
  "disposable": true,
  "score": 100,
  "source": "list",
  "reasons": ["listed:dea,fakefilter,burner,mailchecker,disposable"],
  "free_provider": false,
  "relay_service": false
}

Batch

POST /v1/check/batch takes up to 100 emails or domains and costs 1 unit per item. Results come back in the same order.

curl -X POST https://api.burnerapi.com/v1/check/batch \
  -H "Authorization: Bearer $DEA_KEY" -H "Content-Type: application/json" \
  -d '{"items": ["a@gmail.com", "b@10minutemail.com", "example.org"]}'

Response fields

FieldMeaning
verdictdisposable, suspicious, undeliverable or valid. See below.
disposabletrue only when the verdict is disposable.
scoreRisk from 0 to 100. disposable starts at 70 and suspicious at 40.
sourceWhat decided it: list, engine, static or override.
reasonsMachine-readable signals, e.g. mx_host_shared_with_disposable, risky_tld.
free_providerGmail, Outlook, Yahoo, etc. Real people, but not a business address.
relay_serviceApple Hide My Email, Firefox Relay, DuckDuckGo. These forward to a real inbox, so they aren't counted as disposable.
mxPresent when the engine looked up mail servers: status and hosts.

Verdicts: what to do with them

VerdictSuggested action
disposableBlock the signup, or ask for another address.
undeliverableBlock it. Mail to this domain can't be delivered.
suspiciousAllow it, but require email verification or limit free credits.
validAllow it.

Report a mistake

POST /v1/report with {"input": "domain.com", "kind": "missed" | "false_positive"}. Free. We review reports and push fixes to every customer.

Limits & headers

Each response carries x-plan, x-quota-limit, x-quota-remaining and x-response-time. Quotas reset on the 1st of each month (UTC). Going over your plan's requests per second returns 429, so retry with backoff. Only successful (2xx) responses count toward your quota.

Errors

Errors look like {"error": {"code": "…", "message": "…"}}.

StatusCodeWhen
400missing_input, invalid_inputNo email or domain was given, or it isn't valid.
401missing_api_key, invalid_api_keyThe key is missing, wrong or revoked.
403account_suspendedThe account was suspended.
429rate_limited, quota_exceededToo many requests per second, or this month's quota is used up.

Account & billing endpoints

GET /v1/plans · GET /v1/account (plan, usage, keys) · POST /v1/account/keys · DELETE /v1/account/keys/:id · POST /v1/billing/checkout {"plan"} · POST /v1/billing/portal. The dashboard below uses the same endpoints.

Dashboard

Your account

Paste your API key to see usage and manage your plan. It's kept only in this browser.

No key yet? Get one free.

FAQ

Questions

Do you store the emails I check?

No. Only the domain is used for detection, and verdicts are cached per domain. The part before the @ is never stored.

How fast is it?

Known domains are answered from Cloudflare's edge cache. A domain we haven't seen before needs a live DNS lookup the first time, then it's cached.

Why aren't Apple Hide My Email addresses flagged?

They forward to a real, long-lived inbox, and blocking them hurts real users. Each result includes relay_service: true, so you can apply your own policy.

What happens when I hit my quota?

Requests return 429 quota_exceeded until the month resets or you upgrade. Upgrades take effect within about two minutes.

Can I cancel any time?

Yes. Open the dashboard and click "Manage billing". Your plan stays active until the end of the paid period.