Skip to content

About

A list of disposable/temporary email address domains

Topics

Resources

Stars

1.5k stars

Watchers

27 watching

Forks

Latest commit

ย 

History

408 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿ—‘ Disposable email domains

GitHub last commit

A collection of domains for disposable email services like 10MinuteMail and GuerrillaMail. Also, some ๐Ÿ›  to make your life easier.

Contributions

If you are already familiar with the topic or have good suggestions for automating the crawling processes, feel free to open an issue. We are also looking for people to maintain this project or implement additional pages.

Why?

Use it to validate email addresses on sign up, or just to see how many real email addresses you have in your system.

Usage

We provide an autogenerated list which is updated every 24 hours. To lookup informations about a domain, please use:

https://disposable.github.io/disposable-email-domains/lookup/

Normal Mode

A file containing a sorted list of domains, one domain per line.

curl https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt

Strict Mode

A file containing a sorted list of greylist domains, one domain per line. The greylist contains e-mail services which do allow anonymous signup - domains from this list are only listed in strict mode. Greylist membership is derived from mailservices.json (forwarding/alias services and providers with anonymous signup) plus explicit entries in greylist.txt. For more informations, please check Issue #81.

curl https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains_strict.txt

Java

Checkout ZliIO/zliio-disposable - thanks @ZliIO for the implementation in Java.

Development (Python with uv)

To work with the Python tools in this repo using uv:

pip install --upgrade uv
uv sync --dev
uv run python disposable.py --help
uv run disposable --help
uv run ./.generate

Update the list of domains

To update the list of domains using uv, run uv run ./.generate, and optionally submit a PR.

$ uv run ./.generate
Fetched 5196 domains and 6593 hashes
 - 2000 domain(s) added
 - 75 domain(s) removed
 - 2010 hash(es) added
 - 76 hash(es) removed

Some sources require an API key and are only enabled when the corresponding environment variable is set:

Environment variable Source How to get a key
DUSTMAIL_API_KEY dustmail.net shared inbox domains Register at dustmail.net, then create a dm_live_ key in the Dashboard (free tier is sufficient)
FLARESOLVERR_PROXIES temp-mail.org mailbox sampling Optional comma-separated proxy URLs (e.g. http://user:pass@host:port) - each mailbox request egresses through a different IP

If FLARESOLVERR_URL points to a running FlareSolverr instance (e.g. http://127.0.0.1:8191), sources that answer with a Cloudflare challenge page are automatically retried through it.

Retention and delta guard

Domains seen by sources we crawl ourselves are remembered in source_cache.json next to the output file and kept contributing to the list for --retention-days (default: 30, 0 disables). Retention is opt-in per source via "retain": true in the source config - set on our own scrapers/API crawls so transient fetch failures and rotating-domain providers do not lose coverage. Upstream compilation sources stay unflagged.

Additionally, a run aborts without writing output if more than --max-delta-ratio (default: 0.2, 0 disables) of the previous list would be removed, as mass removal usually indicates a source outage. Runs limited via --src or --file are exempt.

External Sources:

Source Status
https://gist.github.com/adamloving/4401361/ GitHub last update
https://github.com/disposable/static-disposable-lists/ GitHub last commit
https://github.com/wesbos/burner-email-providers/ GitHub last commit
https://github.com/martenson/disposable-email-domains/ GitHub last commit
https://github.com/daisy1754/jp-disposable-emails/ GitHub last commit
https://github.com/FGRibreau/mailchecker/ GitHub last commit
https://github.com/7c/fakefilter/ GitHub last commit
https://github.com/GeroldSetz/Mailinator-Domains GitHub last commit
https://github.com/GeroldSetz/emailondeck.com-domains GitHub last commit
https://throwaway.cloud/ GitHub last commit
https://github.com/castle/disposable-email-domains/ GitHub last commit
https://github.com/jespernissen/disposable-maildomain-list/ GitHub last commit
https://github.com/unkn0w/disposable-email-domain-list/ GitHub last commit

Credits

@adamloving @smeinecke @GeroldSetz @martenson @FGRibreau @daisy1754 @wesbos @7c @copini @ZliIO @iocium @castle @jespernissen @unkn0w

CDN

by: https://raw.githack.com/

About

A list of disposable/temporary email address domains

Topics

Resources

Stars

1.5k stars

Watchers

27 watching

Forks

Releases

Packages

Used by

Contributors

Languages