List of disposable email domains
This repo contains a list of disposable and temporary email address domains often used to register dummy users in order to spam or abuse some services.
We cannot guarantee all of these can still be considered disposable but we do basic checking so chances are they were disposable at one point in time.
Allowlist
The file allowlist.conf gathers email domains that are often identified as disposable but in fact are not.
Example Usage
Python
blocklist = ('disposable_email_blocklist.conf')
blocklist_content = [line.rstrip() for line in blocklist.readlines()]
if email.split('@')[1] in blocklist_content:
message = "Please enter your permanent email address."
return (False, message)
else:
return True
Available as PyPI module thanks to @di
>>> from disposable_email_domains import blocklist
>>> 'bearsarefuzzy.com' in blocklist
True
PHP contributed by @txt3rob, @deguif, @pjebs and @Wruczek
- Make sure the passed email is valid. You can check that with filter_var
- Make sure you have the mbstring extension installed on your server
function isDisposableEmail($email, $blocklist_path = null) {
if (!$blocklist_path) $blocklist_path = __DIR__ . '/disposable_email_blocklist.conf';
$disposable_domains = file($blocklist_path, FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES);
$domain = mb_strtolower(explode('@', trim($email))[1]);
return in_array($domain, $disposable_domains);
}
Ruby on Rails contributed by @MitsunChieh
In the resource model, usually it is user.rb:
before_validation :reject_email_blocklist
def reject_email_blocklist
blocklist = File.read('config/disposable_email_blocklist.conf').split("\n")
if blocklist.include?(email.split('@')[1])
errors[:email] << 'invalid email'
return false
else
return true
end
end
Alternatively you can use the disposable_mail gem: https://github.com/oesgalha/disposable_mail.
NodeJs contributed by @martin-fogelman
'use strict';
const readline = require('readline'),
fs = require('fs');
const input = fs.createReadStream('./disposable_email_blocklist.conf'),
output = [],
rl = readline.createInterface({input});
// PROCESS LINES
rl.on('line', (line) => {
console.log(`Processing line ${output.length}`);
output.push(line);
});
// SAVE AS JSON
rl.on('close', () => {
try {
const json = JSON.stringify(output);
fs.writeFile('disposable_email_blocklist.json', json, () => console.log('--- FINISHED ---'));
} catch (e) {
console.log(e);
}
});
C#
private static readonly Lazy<HashSet<string>> _emailBlockList = new Lazy<HashSet<string>>(() =>
{
var lines = File.ReadLines("disposable_email_blocklist.conf")
.Where(line => !string.IsNullOrWhiteSpace(line) && !line.TrimStart().StartsWith("//"));
return new HashSet<string>(lines, StringComparer.OrdinalIgnoreCase);
});
private static bool IsBlocklisted(string domain) => _emailBlockList.Value.Contains(domain);
...
var addr = new MailAddress(email);
if (IsBlocklisted(addr.Host)))
throw new ApplicationException("Email is blocklisted.");
Contributing
Feel free to create PR with additions or request removal of some domain (with reasons).
Specifically, if adding more than one new domain, please cite in your PR where one can generate a disposable email address which uses that domain, so the maintainers can verify it.
Please add new disposable domains directly into disposable_email_blocklist.conf in the same format (only second level domains on new line without @), then run maintain.sh. The shell script will help you convert uppercase to lowercase, sort, remove duplicates and remove allowlisted domains.
Changelog
-
2/11/21 We created a github org account and transferred the repository to it.
-
4/18/19 @di joined as a core maintainer of this project. Thank you!
-
7/31/17 @deguif joined as a core maintainer of this project. Thanks!
-
12/6/16 - Available as PyPI module thanks to @di
-
7/27/16 - Converted all domains to the second level. This means that starting from this commit the implementers should take care of matching the second level domain names properly i.e.
@xxx.yyy.zzzshould matchyyy.zzzin blocklist more info in #46
41 Sep 10, 2022
2 Jan 26, 2022
2 Nov 4, 2021
63 Dec 24, 2022
452 Jan 5, 2023
28 Dec 6, 2022
6 Mar 16, 2022
9 Aug 25, 2022
1 Feb 16, 2022
211 Dec 17, 2022
116 Dec 24, 2022
2 Apr 10, 2022
1 Nov 14, 2021
2 Aug 18, 2022
36 May 2, 2022
11 Aug 1, 2022
6 Apr 28, 2022
2 Oct 14, 2021
7 Jan 5, 2023