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

Without a key: 10 checks an hour and 30 a day per network, from your server. 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

Docs · Methodology · llms.txt

Metadata

Release files for disban 0.2.0

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.2.0
File Size Uploaded Provenance Actions
disban-0.2.0.tar.gz 5.6 kB Without provenance Details for disban-0.2.0.tar.gz

Built distribution (wheel)

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

Total release size: 11.2 kB

Release files / disban-0.2.0.tar.gz

Download URL disban-0.2.0.tar.gz
Size 5.6 kB
Tags Source
SHA-256 checksum
How to use checksums
07feda16d778144889b5a3bd7f31030d39c7f313d701628e4c18fbfed230cdd6
BLAKE2b-256 checksum
How to use checksums
55cd5b6a1a983f3175f3715a98d4beed536b9ce7642dcea97dd7999b5cdbb5a7
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.2.0-py3-none-any.whl

Download URL disban-0.2.0-py3-none-any.whl
Size 5.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ebb4aaf30b4e36d86b03950c2b00c1d77d4a8eeee62330b17d11eb6fd18add21
BLAKE2b-256 checksum
How to use checksums
ed22b5b5ef3eadb66d341483a61f22c6c7d17849ff18e5bccff8e588d1a20bbe
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.2.0

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