disposable-email-domains /disposable-email-domains

a list of disposable email domains

★ 5,718⑂ 903👁 86⑃ 1,049● 216▤ 0
PythonNOASSERTIONCreated 2014-09-02
+5
Daily
5,718
stars
903
forks
86
watchers
1,049
prs
216
issues
0
releases

README

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.

 One of the most impactful mechanisms we currently have is prohibiting known "throw-away" email domains from creating accounts on the index. We currently use the disposable-email-domains list as well as our own internal list to block registration with -or association of - such domains for PyPI accounts.

-- Ee Durbin, PyPI Admin, Director of Infrastructure (PSF) link

Contributing
============
Feel free to create PR with additions or request removal of some domain (with reasons).

Specifically, please provide a screenshot in your PR of a page where one can generate a disposable email address which uses that domain.

Add new disposable domains directly into disposable_email_blocklist.conf in the same format (only second level domains on new line without @, unless they use public suffix, in which case include the 3rd level domain), then run:

bash
 Create and activate a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate

 Install dependencies
pip install -r requirements.txt

 Validate and auto-fix the blocklist
python verify.py --fix


This will automatically fix formatting issues (lowercase, sorting, duplicates) and validate against public suffix rules. The older maintain.sh script is deprecated — it only does basic lowercase/sort/uniq without PSL validation.

License
=======
You can copy, modify, distribute and use the work, even for commercial purposes, all without asking permission.



Changelog
============

 1/9/25 Enabled GitHub sponsorhip for this work. Everybody can do it, but currently only one person does it. Send them $2 for a coffee if you care.

 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.zzz should match yyy.zzz in blocklist where zzz is a public suffix. More info in 46

 9/2/14 - First commit 393c21f5

Example Usage
=============

TOC: Python, PHP, Go, Ruby, NodeJS, C, bash, Java, Kotlin, Swift, Elixir

 Python
Python
with open('disposable_email_blocklist.conf') as blocklist:
    blocklist_content = {line.rstrip() for line in blocklist.readlines()}

domain_parts = email.partition('@')[2].split(".")
for i in range(len(domain_parts) - 1):
    if ".".join(domain_parts[i:]) in blocklist_content:
        message = "Please enter your perm

Top issues

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON