disposable-email-domains

disposable-email-domains: Block Disposable Email Domains

A maintained blocklist of disposable and temporary email domains for teams that want to limit throwaway-account abuse. Use the plain-text list across languages, with validation tooling and a Python package available.

View on GitHub Compare
Stars
5.7k
Forks
904
Stars, last 30 days
+141
Last commit
1 day ago
Contributors
100+

Our take

Activeregular commits

Health score

69/100

How it is scored
Activity
52
Community
82
Issues
56
Pull requests
84

+141 stars in the last 30 days

  • Merges more pull requests than 96% of the projects we track
  • More contributors than 78% of the projects we track

This is a focused, actively maintained data resource with broad language examples, but teams must implement careful domain and public-suffix matching themselves.

Good fit if

  • You need a reusable disposable-email list for signup screening, rather than a complete email-validation service.
  • Your application can consume a text file or the Python package and handle domain-suffix matching.
  • You want a project with recent commit and merge activity, a broad contributor base, and a CC0 dedication stated in the README.

Look elsewhere if

  • You need an integrated filtering service or turnkey API, which this repository does not describe.
  • Your policy requires a release in the past year, as the repository has no releases in that period.
  • You cannot maintain your own matching behavior or review blocklist decisions for your use case.
All health signals
Last commit2026-11-04 (1 day ago)
Commits, last 90 days100+
Releases, last 12 months0
Contributors100+ (top contributor: 44% of commits)
Issues closed, last 90 days10+ (typically closed in 6 days)
Pull requests merged, last 90 days94 (typically merged in 0 days)
Project age12 years

Checked on 2026-11-06 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

5,730

Forks

907

Change since Nov 17, 2026: +6 stars·0 forks

Overview

disposable-email-domains is a plain-text blocklist of disposable and temporary email domains, intended to help services limit dummy-account creation, spam, and abuse. The project is built around disposable_email_blocklist.conf, rather than a runtime-specific filtering engine, so applications in different languages can consume the same data.

The list is useful for account-registration checks and is referenced by PyPI alongside its own internal list. Entries are generally second-level domains; consumers should check the email domain and its parent domains, taking public suffixes into account. The repository also provides a Python package and examples for using the list from other languages.

Key Features

  • Publishes the blocklist as a simple text file for use from multiple programming languages.
  • Includes Python examples for loading the list and checking domain suffixes.
  • Offers a Python package through PyPI for access to the blocklist.
  • Provides verify.py to normalize entries and validate them against public suffix rules.
  • Accepts pull requests to add domains or request removals, asking contributors to provide evidence.
  • Documents integration examples for PHP, Go, Ruby, Node.js, C#, Bash, Java, Kotlin, Swift, and Elixir.

Use Cases

  • A web service can reject or review registrations using known throwaway email domains.
  • A product team can share one blocklist across services written in different languages.
  • A Python application can use the published package instead of managing its own copy of the data.
  • Maintainers can propose list corrections with evidence and run the repository's validator before submitting changes.

What you need

Detected in the repository

  • Python (from requirements.txt)
  • Automated checks on GitHub Actions

Getting Started

For Python, install the package with pip install disposable-email-domains. For other languages, download disposable_email_blocklist.conf and follow the relevant example in the README.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • disposable-email-validator: A TypeScript validation library with configurable signup rules, rather than a maintained plain-text domain blocklist with validation tooling and a Python package.
ProjectLanguageLicenseStarsStatus
disposable-email-domainsPython–5.7kActive
disposable-email-validatorTypeScriptMIT120Inactive

Considerations

  • A domain on the list is not guaranteed to still provide disposable email; the project says entries may have been disposable at some point and applies basic checks.
  • Matching is an integration responsibility. Because entries are generally stored at the second-level domain, matching only the exact email host can miss listed parent domains, while ignoring public suffixes can produce incorrect results.
  • The project is active, with frequent recent commits and pull-request merges, but its lack of releases in the last year means consumers should decide how they will track list updates.
  • The README states that the work may be copied, modified, distributed, and used commercially without permission, and identifies it as CC0. The GitHub API reports the license as NOASSERTION, so verify the repository's licensing files for your requirements.
  • The repository lists Python requirements for its validation tooling; the blocklist itself is plain text and can be consumed without adopting a Python runtime.

Found this useful?

Share it with someone who would like disposable-email-domains.

Comparisons