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 check someone@mailinator.com example.com

Docs · Methodology · llms.txt

Metadata

Release files for disban 0.1.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.1.0
File Size Uploaded Provenance Actions
disban-0.1.0.tar.gz 3.8 kB Without provenance Details for disban-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 7.9 kB

Release files / disban-0.1.0.tar.gz

Download URL disban-0.1.0.tar.gz
Size 3.8 kB
Tags Source
SHA-256 checksum
How to use checksums
92f90541be63104af5f41baa4bd8382c72912956429d8000c323a29aef9f7e4c
BLAKE2b-256 checksum
How to use checksums
9c4cf9fe431f96f198b4d13fb12efdec8c3a4cdd69b45533b156190df7ad8f31
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.1.0-py3-none-any.whl

Download URL disban-0.1.0-py3-none-any.whl
Size 4.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
47c40e1ad05c9e9fd19a214200dec95b316aed80a09eb5cf7d4d3b5e76009287
BLAKE2b-256 checksum
How to use checksums
1dc01bdcdf76dd4cfb55e90e62bb1f0a3aab9a3565b2e3a4eca330e26ee80545
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.1.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