Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

A database of free and disposable email domains

Project Description


A database of free and disposable email domains and a handy Node.js module for querying it.

Install via npm or pip or access the files in the ./data directory and parse with your language of choice.

In an effort to create the most up-to-date list of domains, the database can be synchronized with various lists from around the web. You can also add new domains directly by opening a pull request.


There are three key data files in this project:

  • free.txt contains a list of domains that are known to provide free email service
  • disposable.txt contains a list of domains that are known to provide disposable email service
  • blacklist.txt contains a list of domains that this project will refuse to add to either list

Domains may only be a member of one list.

Updating the database

Run ./update to pull in the latest domains from the sources listed in sources.txt. All new domains will be placed in free.txt by default. If any domains provide disposable email service, they may be moved to disposable.txt.



pip install freemail
>>> import freemail
>>> freemail.is_free('')
>>> freemail.is_free('')
>>> freemail.is_disposable('')
>>> freemail.is_disposable('')

Release History

This version
History Node


History Node


History Node


Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, Size & Hash SHA256 Hash Help File Type Python Version Upload Date
(22.8 kB) Copy SHA256 Hash SHA256
Wheel 2.7 Sep 23, 2016
(22.9 kB) Copy SHA256 Hash SHA256
Source None Sep 23, 2016

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Google Google Cloud Servers