Free Every check costs nothing
Disposable Email Check API
Run every new signup and lead through the Disposable Email Check API before it reaches your product, CRM or outbound sequences.
- Completely free, every check
Check an address
GET/v1/emails/disposable
Opens in the API playground with your address filled in. No credits used.
Disposable domainmailinator.com is on the current list
- You sent
- jane@mailinator.com
- data.domain
- mailinator.com
- data.isDisposable
- true
- meta.creditCost
- 0
Next step: ask for a work or personal address.
{ "data": { "domain": "mailinator.com", "isDisposable": true }, "meta": { "creditCost": 0 }}What is a disposable email address?
A disposable email address, also called a temporary, throwaway, or burner email, comes from a service that hands out an inbox to anyone for a few minutes or hours with no signup. People use one to get past an email gate without sharing a real address. Once the inbox expires, there is no way to reach that person again.
That shows up as trial abuse, duplicate free accounts, welcome emails that bounce, and CRM records nobody can follow up on. The Disposable Email Check API tells you, at the moment of signup, whether the domain belongs to one of these services. It costs no credits, so you can run it on every form without thinking about the bill.
How the disposable email check works
Send an email address and the API tells you whether its domain belongs to a disposable email provider.
You send the email
jane@
mailinator.com One GET request with the
emailparameter.We check the domain
mailinator.com
Matched against our list of disposable email providers.
You get the answer
isDisposable: true
Block it, ask for another address, or let it through.
What to do when an email is disposable
You don't have to turn the user away. Pick an option to see how it looks in your product.
Many teams ask for a different address and let the user continue, which keeps conversion high and cuts abuse.
Create your account
Email address
jane@mailinator.com
This looks like a temporary inbox. Please use a work or personal address so you can receive account emails.
ContinueWelcome to your trial
Free trial creditsOn hold
Confirm a work or personal email address to unlock your free credits.
Add another addressNew leads
| Lead | Status | |
|---|---|---|
| Mia Chen | mia@northwind.example | OK |
| J. Doe | x7k2@mailinator.com | Disposable |
| Sam Patel | sam@contoso.example | OK |
Add it in three steps
One GET request from your backend. Copy a sample in your language.
Create a free API key
Sign up and copy the key from your dashboard. Keep it on the server: the check runs from your backend, never from the browser.
Call it when the form is submitted
Send the address your user typed as the
emailquery parameter. Only the domain after the @ is used.Handle disposable addresses
When it is
true, ask for another address, hold free credits, or flag the lead. When it isfalse, carry on as usual.
const url = new URL("https://api.envoapi.com/v1/emails/disposable");url.searchParams.set("email", form.email);const response = await fetch(url, { headers: { Authorization: `Bearer ${process.env.ENVO_API_KEY}` },});const { data } = await response.json();if (data.isDisposable) { // Ask for a work or personal address instead.}import osimport requestsresponse = requests.get( "https://api.envoapi.com/v1/emails/disposable", headers={"Authorization": f"Bearer {os.environ['ENVO_API_KEY']}"}, params={"email": form["email"]},)data = response.json()["data"]if data["isDisposable"]: # Ask for a work or personal address instead. ...curl -G "https://api.envoapi.com/v1/emails/disposable" \ --data-urlencode "email=jane@mailinator.com" \ -H "Authorization: Bearer $ENVO_API_KEY"{ "data": { "domain": "mailinator.com", "isDisposable": true }, "meta": { "creditCost": 0 }}Response reference
Response fields
- data.domainstring
- The domain we checked, lowercased and normalized. Log it so you know exactly what was matched.
- data.isDisposableboolean
truewhen the domain is on the current disposable-domain list,falsewhen it is not.- meta.creditCostnumber
- Always 0, whether the domain is listed or not.
Headers
- X-RateLimit-*
- Your limit, how many requests you have left, and when the window resets. On every 200.
- X-Request-Id
- On every response. Quote it when you contact support.
- Cache-Control
private, no-store, so each request reflects the current list.
Status codes
- 200
- The check ran. Read
data.domainanddata.isDisposable. - 400
- The
emailparameter is missing or invalid. - 401
- Your API key is invalid or inactive.
- 403
- Your API key or account cannot access this endpoint.
- 405
- Use GET for this endpoint.
- 406
- The format in your Accept header is not supported.
- 415
- The Content-Type in your request is not supported.
- 429
- Too many requests. Wait for the Retry-After header.
- 500
- A server error stopped the request. Retry later.
- 503
- The domain list or a required dependency is unavailable. Retry after the Retry-After header when one is sent.
Every error carries a code, a message, a retryable flag, and meta.requestId so support can find the request.
Use cases for a disposable email check
Anywhere an email address unlocks something of value.
Signup forms
Run the check when the form is submitted. If the domain is disposable, ask for a work or personal address instead of creating the account.
Free trials and credits
Stop one person from opening ten trials with ten temporary inboxes. Send disposable signups through extra verification before you grant credits or trial days.
Imports and CRM hygiene
Flag disposable addresses as leads arrive from forms, imports, and partners. Sales stops chasing inboxes that will be gone next week, and reports count only real contacts.
Gated content and demo requests
People use temporary inboxes to grab a PDF and vanish. Check the address before you send the asset, so your follow-up list holds real prospects.
Waitlists, giveaways and referrals
Keep contest entries and referral rewards for real people. One check per entry costs nothing, so there is no reason to skip it.
Bounce rate and sender reputation
Temporary inboxes expire and then bounce. Drop them before a campaign goes out instead of after the bounces come back.
Disposable email check vs. email verification
Use the free check on every signup. Verify the mailbox when you need to know it can receive mail.
Disposable Email Check
You're hereGET/v1/emails/disposable
- Tells you if the address comes from a disposable email provider.
- Never contacts the mail server.
- Free, so you can run it on every signup.
Email Verification
Uses creditsGET/v1/emails/verify
- Asks the mail server whether the mailbox exists, without sending an email.
- Returns valid, invalid or unverifiable, with a reason.
- Also flags catch-all and disposable domains.
Questions, answered
Can't find what you need? Contact us or read the API reference.
What is a disposable email address?
A disposable, temporary, or burner email address comes from a service that gives anyone an inbox for a few minutes or hours with no signup. People use them to get past email gates without sharing a real address. Accounts created with them are hard to recover, rarely convert, and often bounce later.
Does this check that the mailbox exists?
No. It checks only whether the domain after the @ is a known disposable email domain. It does not check that the mailbox exists or that mail will be delivered. Use the Email Verification API for that.
What does a check cost?
Nothing. Every successful response reports a creditCost of 0, whether the domain is disposable or not. Your plan's rate limits still apply.
Can I check a domain instead of a full email address?
The endpoint takes an email address, but only the domain is used. Send any address on that domain, such as check@domain.com, and read data.domain in the response.
Does it handle uppercase letters or plus-addressing?
Yes. The domain is lowercased and normalized before the check, and everything before the @ is ignored. Jane+promo@Mailinator.com and jane@mailinator.com give the same result.
What counts as a match?
An exact match on the normalized domain. The domain after the @ is either on the current disposable-domain list or it is not. The response returns that domain so you can log what was checked.
Does a free check count against my rate limit?
Yes. It costs no credits, but each request counts toward your rate limit. If you go over it you get a 429 with a Retry-After header.
Are results cached?
No. Every response is sent with Cache-Control: private, no-store, so each request reflects the current domain list.
What happens if the service is unavailable?
The API returns 503 when the domain list or a required dependency is unavailable, with a Retry-After header when a retry time is known. Until it recovers, treat the address as unknown, not as safe.
Should I block disposable signups?
That is your call. Many teams ask for a different address and let the user continue, which keeps conversion high and cuts abuse. Others allow the signup but hold free credits or trial features until a real address is confirmed.
Start checking signups today
Create an API key, add one GET request to your form handler, and stop temporary inboxes from turning into fake accounts. Every check is free.