https://github.com/disposable/disposable
A list of disposable/temporary email address domains
https://github.com/disposable/disposable
disposable disposable-email disposable-email-addresses email javascript temporary-email
Last synced: 16 days ago
JSON representation
A list of disposable/temporary email address domains
- Host: GitHub
- URL: https://github.com/disposable/disposable
- Owner: disposable
- License: mit
- Created: 2015-02-02T15:13:55.000Z (about 10 years ago)
- Default Branch: master
- Last Pushed: 2025-03-11T13:45:39.000Z (about 1 month ago)
- Last Synced: 2025-03-11T14:36:23.470Z (about 1 month ago)
- Topics: disposable, disposable-email, disposable-email-addresses, email, javascript, temporary-email
- Language: Python
- Homepage:
- Size: 7.88 MB
- Stars: 1,045
- Watchers: 35
- Forks: 128
- Open Issues: 38
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-opensource-email - disposable - A list of disposable/temporary email address domains - `MIT`, `Python` (Security / Disposable emails domain list)
README
# 🗑 Disposable email domains
[](https://www.npmjs.com/package/disposable-email)
[](https://godoc.org/github.com/disposable/disposable)
A collection of domains for disposable email services like [10MinuteMail](http://10minutemail.com) and [GuerrillaMail](https://www.guerrillamail.com). 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](https://github.com/disposable/disposable/issues/new). 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/](https://disposable.github.io/disposable-email-domains/lookup/)
### Normal Mode
A [file](https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt)
containing a sorted list of domains, one domain per line.
```shell
curl https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains.txt
```
### Strict Mode
A [file](https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains_strict.txt)
containing a sorted list of domains from [greylist.txt](https://github.com/disposable/disposable/blob/master/greylist.txt), 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.
For more informations, please check Issue [#81](https://github.com/disposable/disposable/issues/81).
```shell
curl https://raw.githubusercontent.com/disposable/disposable-email-domains/master/domains_strict.txt
```
### JavaScript
Install the npm package `disposable-email`. Validate synchronously or with a callback.
```shell
npm i --save disposable-email
```
```javascript
var disposable = require('disposable-email');
disposable.validate('gmail.com');
// true
disposable.validate('[email protected]');
// true
disposable.validate('gmail.com', console.log);
// undefined
// null true
```
### Go
```go
import "github.com/disposable/disposable"
if disposable.Domain("gmail.com") {
panic("Uh oh!")
}
```
### Java
Checkout [ZliIO/zliio-disposable](https://github.com/ZliIO/zliio-disposable) - thanks @ZliIO for the implementation in Java.
## Update the list of domains
To update the list of domains run `.generate` (requires `python3`), and optionally submit a PR.
```shell
$ ./.generate
Fetched 5196 domains and 6593 hashes
- 2000 domain(s) added
- 75 domain(s) removed
- 2010 hash(es) added
- 76 hash(es) removed
```
## External Sources:
|Source|Status|
|------|--:|
|https://gist.github.com/adamloving/4401361/||
|https://gist.github.com/jamesonev/7e188c35fd5ca754c970e3a1caf045ef/||
|https://github.com/disposable/static-disposable-lists/||
|https://github.com/wesbos/burner-email-providers/||
|https://github.com/martenson/disposable-email-domains/||
|https://github.com/daisy1754/jp-disposable-emails/||
|https://github.com/FGRibreau/mailchecker/||
|https://github.com/7c/fakefilter/||
|https://github.com/flotwig/disposable-email-addresses/||
|https://github.com/GeroldSetz/emailondeck.com-domains||
|https://www.rotvpn.com/en/disposable-email||
|https://www.stopforumspam.com/downloads/toxic_domains_whole.txt||
## Credits
[@adamloving](https://github.com/adamloving)
[@michenriksen](https://github.com/michenriksen)
[@ivolo](https://github.com/ivolo)
[@smeinecke](https://github.com/smeinecke)
[@GeroldSetz](https://github.com/GeroldSetz)
[@martenson](https://github.com/martenson)
[@FGRibreau](https://github.com/FGRibreau)
[@daisy1754](https://github.com/daisy1754)
[@jamesonev](https://github.com/jamesonev)
[@wesbos](https://github.com/wesbos)
[@willwhite](https://github.com/willwhite)
[@stopforumspam](https://github.com/stopforumspam)
[@7c](https://github.com/7c)
[@copini](https://github.com/copini)
[@ZliIO](https://github.com/ZliIO)
### CDN
* Production: https://rawcdn.githack.com/disposable/disposable-email-domains/master/domains.json
* Development: https://raw.githack.com/disposable/disposable-email-domains/master/domains.json
by: https://raw.githack.com/