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.
- 50 free checks
- No credit card required
- Syntax
Format and parts of the address - Domain & MX
Mail servers for the domain - Mailbox
Does this exact mailbox exist - Result
Status, reason and flags
Press Verify to watch the four checks run.
{ "data": { "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": { "creditCost": 2 }}{ "data": { "email": "s.colins@brightpathlabs.com", "user": null, "domain": "brightpathlabs.com", "mx": "aspmx.l.google.com", "status": "invalid", "reason": "rejected", "isCatchAll": false, "isDisposable": false }, "meta": { "creditCost": 2 }}{ "data": { "email": "sarah@brightpath-labs.co", "user": null, "domain": "brightpath-labs.co", "mx": null, "status": "invalid", "reason": "no_mx", "isCatchAll": false, "isDisposable": false }, "meta": { "creditCost": 2 }}{ "data": { "email": "promo4u@tempmail-drop.com", "user": null, "domain": "tempmail-drop.com", "mx": "mx.tempmail-drop.com", "status": "invalid", "reason": "disposable", "isCatchAll": false, "isDisposable": true }, "meta": { "creditCost": 2 }}{ "data": { "email": "ops@harborline-freight.com", "user": null, "domain": "harborline-freight.com", "mx": "mail.harborline-freight.com", "status": "unverifiable", "reason": "timeout", "isCatchAll": false, "isDisposable": false }, "meta": { "creditCost": 2 }}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.
- validSend
The mailbox exists
The mail server accepted this exact address.
accepted
- invalidDon't send
It can't receive email
The server rejected the mailbox, the domain has no mail server, or it's a throwaway domain.
rejectedno_mxdisposable
- unverifiableReview
The server wouldn't say
It didn't confirm or deny the mailbox. Many of these clear up on a retry later.
timeoutlimitedmx_errorspam_block
isCatchAll
True when the domain accepts every address. A valid result on a catch-all domain is weaker proof that this mailbox exists. Reason
catch_allmeans it can't be confirmed on its own.isDisposable
True when the domain is a known throwaway email provider. These return
invalidwith reasondisposable.
Built for signups, campaigns and CRM data
Stop bad addresses wherever they enter: forms, sending lists, sales tools and imports.
Signup and onboarding forms
Catch typos and fake addresses while the user is still on the page. Ask for a correction instead of losing them to a bounced welcome email.
Campaigns and newsletters
Clean a list before a send. Remove invalid addresses so bounces stay low and your sending domain keeps its reputation.
Sales outreach and CRM data
Verify leads before they enter a sequence. Flag catch-all domains so reps know which addresses are confirmed and which are a guess.
Imports and lead scoring
Check purchased or imported lists as they arrive. Route unverifiable rows for review instead of dropping them or sending blind.
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
statusvalid: 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.reasonWhy you got that status, as a fixed code you can switch on. All 9 codes are explained below.
isCatchAlltruewhen the domain accepts any address. Treat avalidhere as unconfirmed.isDisposabletruewhen 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.
curl -G "https://api.envoapi.com/v1/emails/verify" \ -H "Authorization: Bearer $ENVO_API_KEY" \ --data-urlencode "email=sarah.collins@brightpathlabs.com"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 acceptedWhat each reason code means
The reason field tells you why you got a status. Here's each code and what to do with it.
| Reason | What it means | What to do |
|---|---|---|
accepted | The mail server accepted the mailbox. | Send |
rejected | The mail server said the mailbox does not exist. | Remove |
no_mx | The domain has no mail servers, so it cannot receive email. | Remove |
disposable | The address belongs to a disposable email service. It returns invalid with isDisposable true. | Remove |
catch_all | The domain accepts every address, so this one cannot be confirmed on its own. | Review |
timeout | The mail server did not answer in time. | Retry later |
mx_error | The mail server returned an error during the check. | Retry later |
limited | The mail server rate-limited the check. | Retry later |
spam_block | The 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.
Send
javascript data.status === "valid" && !data.isCatchAll && !data.isDisposableThe mailbox exists, and the domain is neither catch-all nor disposable.
Review
javascript data.status === "unverifiable" || data.isCatchAllThe server could not confirm the mailbox, or the domain accepts everything. Retry later, or send only when the lead is worth the bounce risk.
Don't send
javascript data.status === "invalid" || data.isDisposableThe server rejected the mailbox, the domain has no mail server, or it is a throwaway domain.
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
- Create a free account
You get 100 free credits, enough for 50 checks. No credit card required.
- Create a key
Open API keys in your dashboard and create a new key.
- Send one GET request
Pass the address as
emailand your key as a Bearer token. Call it from your backend so the key never reaches the browser.
Email verification pricing and refunds
Each check costs 2 credits. If a check can't run, you get the credits back.
2 credits per check
Every verification costs the same. That includes unverifiable results, because the check ran even when the server gave no clear answer.
Yahoo isn't supported yet
Addresses at yahoo.* domains, ymail.com and rocketmail.com return 422 with error code
email_unverifiable, and the credits come back.Capacity errors are refunded
If verification is at capacity or temporarily down, you get 503 with a
Retry-Afterheader and the credits come back.Headers for batch jobs
Every response carries
X-Credits-RemainingandX-RateLimit-*headers so you can pace a list and stop before you run out.Never cached
Each call is a live check. Checking the same address twice means two live checks and two charges.
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.
Verify Email
GET
/v1/emails/verifyChecks whether a mailbox exists without sending an email. Returns a status, a reason, and catch-all and disposable flags.
statusreasonisCatchAllisDisposablemx
2 creditsThis pageRead the docs: Verify EmailCheck Disposable Email
GET
/v1/emails/disposableTells you if the domain is a known throwaway provider. It's free, so you can run it on every signup.
domainisDisposable
Find Email
GET
/v1/emails/findGive a first name, last name and company domain. EnvoAPI tests common address patterns with the mail server and returns the one it accepts.
emailstatuscandidatesCheckedverification
10 creditsEmail Finder APIRead the docs: Find Email
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