README.md

Disposable email domains

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

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

• list

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

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

• JSON array

A file containing a sorted array of domains, in JSON format.

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

• javascript

Install the npm package disposable-email. Validate synchronously or with a callback.

npm i --save disposable-email

var disposable = require('disposable-email');

disposable.validate('gmail.com');
// true

disposable.validate('foo@gmail.com');
// true

disposable.validate('gmail.com', console.log);
// undefined
// null true

• Go

import "github.com/andreis/disposable"

if disposable.Domain("gmail.com") {
    panic("Uh oh!")
}

Update the list of domains

To update the list of domains run .generate (requires python3), and optionally submit a PR.

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

Credits

• https://github.com/adamloving
• https://github.com/michenriksen
• https://github.com/ivolo
• https://github.com/smeinecke
• https://github.com/GeroldSetz

CDN

Production: https://rawcdn.githack.com/andreis/disposable-email-domains/master/domains.json

Development: https://raw.githack.com/andreis/disposable-email-domains/master/domains.json

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