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.

Example response200

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.

Response200examplejson
{  "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.

  1. You send the email

    jane@mailinator.com

    One GET request with the email parameter.

  2. We check the domain

    mailinator.com

    Matched against our list of disposable email providers.

  3. 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.

Continue

Welcome to your trial

Free trial creditsOn hold

Confirm a work or personal email address to unlock your free credits.

Add another address

New leads

LeadEmailStatus
Mia Chenmia@northwind.exampleOK
J. Doex7k2@mailinator.comDisposable
Sam Patelsam@contoso.exampleOK

Add it in three steps

One GET request from your backend. Copy a sample in your language.

  1. 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.

  2. Call it when the form is submitted

    Send the address your user typed as the email query parameter. Only the domain after the @ is used.

  3. Handle disposable addresses

    When it is true, ask for another address, hold free credits, or flag the lead. When it is false, carry on as usual.

Get your free API key
typescript
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.}
python
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.    ...
bash
curl -G "https://api.envoapi.com/v1/emails/disposable" \  --data-urlencode "email=jane@mailinator.com" \  -H "Authorization: Bearer $ENVO_API_KEY"
Response200application/jsonjson
{  "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
true when the domain is on the current disposable-domain list, false when 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.domain and data.isDisposable.
400
The email parameter 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.

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 here

GET/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 credits

GET/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.
Email Verification API

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.