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

Docs · Methodology · llms.txt

Metadata

Release files for disban 0.3.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.3.0
File Size Uploaded Provenance Actions
disban-0.3.0.tar.gz 6.1 kB Without provenance Details for disban-0.3.0.tar.gz

Built distribution (wheel)

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

Total release size: 12.4 kB

Release files / disban-0.3.0.tar.gz

Download URL disban-0.3.0.tar.gz
Size 6.1 kB
Tags Source
SHA-256 checksum
How to use checksums
327fa3e67f9e6b9346587fa91ae6e8c7f6d0985d9cc3bf84ccc302e467f1709d
BLAKE2b-256 checksum
How to use checksums
71cce685a1271678441b963e64372e646b813efab0b3cb1dff1eb89a3a004ae9
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.0-py3-none-any.whl

Download URL disban-0.3.0-py3-none-any.whl
Size 6.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a38b3ca34619bb7f832da259450f81f53207472ba53820b6471c2ef88c991748
BLAKE2b-256 checksum
How to use checksums
96e36260a2a414bac0e091e73500d1143842577cc6711268d223aff4ff79e8d2
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.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