Skip to main content

disban

Detect disposable email addresses at signup. disban classifies the domain of an email address as disposable, free (Gmail, Outlook), alias (privacy relays such as SimpleLogin), testing, parked or unknown, and tells you whether it can receive mail. Works without an API key. Standard library only.

pip install disban
from disban import is_disposable, signup_decision

is_disposable("someone@yopmail.com")   # True; None means unknown (not verified safe)

decision = signup_decision(email)
if decision["action"] == "block":
    raise ValueError("Please use a permanent email address.")
if decision["action"] == "fix":
    raise ValueError("That domain can't receive email. Check for a typo.")
# "allow": create the account; if decision["hold"], hold free credits until the email is confirmed

signup_decision fails open: if Disban is slow, unreachable or rate-limited, it allows the signup with hold: True.

FastAPI

from fastapi import FastAPI, HTTPException
from disban import signup_decision

app = FastAPI()

@app.post("/signup")
def signup(email: str):
    decision = signup_decision(email)
    if decision["action"] != "allow":
        raise HTTPException(422, decision["reason"])
    return {"ok": True, "review": decision.get("hold", False)}

Limits and API keys

Start straight away without a key: 10 checks an hour and 30 a day per network, from your server. When that runs out, disban check offers to create your free account on the spot, and in server code you'll get a one-time warning telling you to run disban signup. For production, set DISBAN_API_KEY: a free key includes 2,000 checks a month with the evidence behind each result. disban.io/signup

disban signup     # free account and API key from the terminal; saves DISBAN_API_KEY to ./.env if you want
disban login      # new key for an existing account
disban check someone@mailinator.com example.com

Free disposable email checker · Docs · Methodology · llms.txt

Metadata

Release files for disban 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for disban 0.3.1
File Size Uploaded Provenance Actions
disban-0.3.1.tar.gz 6.1 kB Without provenance Details for disban-0.3.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for disban 0.3.1
File Interpreter ABI Platform Actions
disban-0.3.1-py3-none-any.whl Python 3 none any Details for disban-0.3.1-py3-none-any.whl

Total release size: 12.5 kB

Release files / disban-0.3.1.tar.gz

Download URL disban-0.3.1.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
9608bea6b44f60bee09b2aa0319d19096a4314ad9d3587431403084c4229b70d
BLAKE2b-256 checksum
How to use checksums
768bc3cf69959ebf6890fcf3f7de45866c1c608cdfcc288f55a79b03a939aa82
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Release files / disban-0.3.1-py3-none-any.whl

Download URL disban-0.3.1-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
fef1376675ed7af197cbdeea1eea30e0c842b9430bf193369a29395aafa98132
BLAKE2b-256 checksum
How to use checksums
0108fa40b0869b121b37b55743817117172b7fbe3e7e79005a3d3a1483b6e0d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.14.6

Security for disban 0.3.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page