A lightweight Python package to detect disposable/temporary email addresses. Bundles 72,000+ domains from disposable/disposable-email-domains, updated daily — no network calls at runtime.
pip install python-disposablefromdisposable_emailimportis_disposable, is_validis_disposable("user@mailinator.com") # Trueis_disposable("user@gmail.com") # False# Works with bare domains toois_disposable("guerrillamail.com") # True# Inverseis_valid("user@gmail.com") # TrueStrict mode also flags greylisted domains — services that allow anonymous signups but aren't purely disposable (e.g. some free email providers).
is_disposable("example.com", strict=True)
is_valid("example.com", strict=True)Subdomains are automatically resolved to their parent domain.
is_disposable("mail.mailinator.com") # Trueis_disposable("a.b.guerrillamail.com") # Truefromdisposable_emailimportget_domainsdomains=get_domains() # frozenset of 72k+ domainsdomains_strict=get_domains(strict=True) # frozenset of strict listfromdisposable_emailimportdomain_countdomain_count() # 72170domain_count(strict=True) # 26468fromdjangoimportformsfromdisposable_emailimportis_disposableclassRegisterForm(forms.Form):
email=forms.EmailField()
defclean_email(self):
email=self.cleaned_data["email"]
ifis_disposable(email):
raiseforms.ValidationError("Disposable email addresses are not allowed.")
returnemail| Function | Description |
|---|---|
is_disposable(email_or_domain, strict=False) | Returns True if the email/domain is disposable |
is_valid(email_or_domain, strict=False) | Returns True if the email/domain is not disposable |
get_domains(strict=False) | Returns the full frozenset of known disposable domains |
domain_count(strict=False) | Returns the number of bundled domains |
Domain lists are sourced from disposable/disposable-email-domains and bundled at release time. The upstream list is updated daily via automated scraping of 40+ sources.
This package checks for upstream updates every 4 hours and automatically publishes a new version to PyPI when changes are detected.
MIT — see LICENSE.