Live mailbox check · No email sent

Email Verification API: Know the mailbox exists before you hit send

Verify any address in one API call, with no email sent. Each result returns valid, invalid or unverifiable, a reason code, and catch-all and disposable flags.

Example checkexample data · no credits usedVerify your own in the Playground
Try:
  1. SyntaxFormat and parts of the address
  2. Domain & MXMail servers for the domain
  3. MailboxDoes this exact mailbox exist
  4. ResultStatus, reason and flags
Pick an example

Press Verify to watch the four checks run.

Email verification results, explained

Every response has one status and one reason code from a fixed list, so you can branch on them without parsing text.

Built for signups, campaigns and CRM data

Stop bad addresses wherever they enter: forms, sending lists, sales tools and imports.

Only have a name and a company? The Email Finder API finds the address first and verifies it in the same call.

The JSON response, field by field

One object per address. Four fields decide whether you send. The others show what was checked.

GET/v1/emails/verify2 credits

Hover or tap a note to highlight its line

  1. status

    valid: the mailbox exists. invalid: the address can't receive email, because it was rejected, has no mail server or is disposable. unverifiable: the server wouldn't confirm either way.

  2. reason

    Why you got that status, as a fixed code you can switch on. All 9 codes are explained below.

  3. isCatchAll

    true when the domain accepts any address. Treat a valid here as unconfirmed.

  4. isDisposable

    true when the domain is a known throwaway email provider.

email and domain repeat the address you sent. mx is the mail server that answered, and user is the name on the mailbox when one is known. user and mx can be null.

bash
curl -G "https://api.envoapi.com/v1/emails/verify" \  -H "Authorization: Bearer $ENVO_API_KEY" \  --data-urlencode "email=sarah.collins@brightpathlabs.com"
javascript
const api = "https://api.envoapi.com";const key = process.env.ENVO_API_KEY;const email = "sarah.collins@brightpathlabs.com";const url = new URL("/v1/emails/verify", api);url.searchParams.set("email", email);const res = await fetch(url, {  headers: { Authorization: `Bearer ${key}` },});const { data } = await res.json();function bucket({ status, isCatchAll, isDisposable }) {  if (status === "invalid" || isDisposable) {    return "dont-send";  }  if (status === "unverifiable" || isCatchAll) {    return "review";  }  return "send";}console.log(bucket(data), data.reason); // send accepted
Response200example · 2 credits
data: Object
email: "sarah.collins@brightpathlabs.com"
user: "Sarah Collins"
domain: "brightpathlabs.com"
mx: "aspmx.l.google.com"
status: "valid"
reason: "accepted"
isCatchAll: false
isDisposable: false
meta: Object
creditCost: 2
Hover or tap a row to see its path

What each reason code means

The reason field tells you why you got a status. Here's each code and what to do with it.

ReasonWhat it meansWhat to do
acceptedThe mail server accepted the mailbox.Send
rejectedThe mail server said the mailbox does not exist.Remove
no_mxThe domain has no mail servers, so it cannot receive email.Remove
disposableThe address belongs to a disposable email service. It returns invalid with isDisposable true.Remove
catch_allThe domain accepts every address, so this one cannot be confirmed on its own.Review
timeoutThe mail server did not answer in time.Retry later
mx_errorThe mail server returned an error during the check.Retry later
limitedThe mail server rate-limited the check.Retry later
spam_blockThe mail server blocked the check as anti-spam protection.Review

Turn a result into a send decision

Sort each result into send, review or don't send. Copy these conditions and tighten them to the bounce risk you can live with.

If an address matches two buckets, use the stricter one. A sales team may still email a catch-all domain; a newsletter usually shouldn't.

How to verify an email with the API

  1. Create a free account

    You get 100 free credits, enough for 50 checks. No credit card required.

  2. Create a key

    Open API keys in your dashboard and create a new key.

  3. Send one GET request

    Pass the address as email and your key as a Bearer token. Call it from your backend so the key never reaches the browser.

Get your free API key

Email verification pricing and refunds

Each check costs 2 credits. If a check can't run, you get the credits back.

See plans and pricing

More email APIs on the same key

Screen signups for throwaway domains for free, or find an address when all you have is a name and a company.

Email verification API questions

Does the API send an email to the address?

No. The check connects to the domain's mail server and stops before any message is sent, so nothing reaches the inbox.

Will verifying emails hurt my sender reputation?

No. Checks don't use your domain or your mail server, and no email is sent.

What does unverifiable mean?

The mail server would not confirm or deny the mailbox. The reason code says why, for example timeout, limited, mx_error or spam_block. Many of these cases clear up on a retry later.

What is a catch-all domain?

A domain whose mail server accepts every address, real or not. Verify Email flags it with isCatchAll. Find Email returns no address for these domains, because every pattern would be accepted.

Why isn't a regex check enough?

A regex only checks the format. It cannot tell you whether the domain has mail servers or whether the mailbox exists. Verification asks the server that would deliver the email.

How much does email verification cost?

2 credits per address. The free plan includes 100 credits, enough for 50 checks, and no credit card is needed.

Do I pay for unverifiable results?

Yes, 2 credits like any other check, because the check ran. Credits are refunded only when the check could not run: Yahoo addresses (422) and provider capacity errors (503).

Can I verify a whole list?

Each request verifies one address. To clean a list, call the endpoint once per address and use the X-RateLimit-* headers to pace the job.

Are results cached?

No. Every call is a live check against the mail server, so you always see its current answer. Save the result on your side if you'll need it again, since a repeat check is charged again.

Can I verify Yahoo addresses?

Not yet. Addresses at yahoo.* domains, ymail.com and rocketmail.com return 422 with error code email_unverifiable. The request is not retryable and the credits are refunded.

What happens when verification is unavailable?

If verification is at capacity or temporarily down, the request fails with a 503, the credits are refunded, and the Retry-After header says when to try again.

Is the disposable email check free?

Yes. Check Disposable Email costs no credits, including when the domain is not listed. It only checks the domain, not whether the mailbox exists.

What is the difference between Verify Email and Find Email?

Verify Email checks an address you already have. Find Email discovers an address from a name and a company domain, then verifies it.

Start with 50 free checks

Sign up, copy your key and call the endpoint below. No credit card required.

GEThttps://api.envoapi.com/v1/emails/verify