mailrambo
Official Python client for the MailRambo email verification API.
One call answers one question - can I send to this address without bouncing? deliverable is True only when the mailbox is confirmed; catch-all, disposable and unverifiable addresses are False, with a reason you can branch on.
- Sync and asyncio clients, typed, one dependency (
httpx) - Automatic retries on 429/5xx with backoff
- Retry-safe batches (idempotency keys added for you)
- Free test keys (
mr_test_...) - build and run CI without spending credits
Install
pip install mailrambo
Get a free API key (100 verifications/month, API on every plan) at mailrambo.com.
Quick start
from mailrambo import MailRambo
mr = MailRambo() # reads MAILRAMBO_API_KEY
result = mr.verify("jane@acme.com")
if not result["deliverable"]:
print("Don't send:", result["reason"]) # mailbox_not_found, disposable, catch_all, ...
Async
from mailrambo import AsyncMailRambo
async with AsyncMailRambo() as mr:
result = await mr.verify("jane@acme.com")
Block fake signups (Django / FastAPI)
BLOCK = {"disposable", "mailbox_not_found", "invalid_syntax", "spamtrap"}
def is_allowed_signup(email: str) -> bool:
try:
return mr.verify(email)["reason"] not in BLOCK
except MailRamboError:
return True # fail open: never lose a real user to a timeout
Fast mode for signup forms (free)
r = mr.verify("jane@gmial.com", mode="fast") # < 1s, no credit
r["deliverable"] # False = reject (invalid_syntax, possible_typo, disposable, no_mx); None = looks fine, mailbox not checked
r["suggestion"] # "jane@gmail.com"
Repeat checks of the same address within 24 hours are also free (cached: True).
Full detail
r = mr.verify("jane@acme.com", detail=True)
r["detail"]["grade"] # "A"
r["detail"]["inbox_provider"] # "Google Workspace"
r["detail"]["dns"]["dmarc_policy"] # "reject"
Same price (1 credit).
Lists
rows = mr.verify_many(emails, name="Q4 import") # any size, batches of 200, input order kept
good = [r["email"] for r in rows if r["deliverable"]]
# or manage batches yourself
batch_id = mr.create_batch(emails[:200], idempotency_key="import-42")["batch_id"]
batch = mr.wait_for_batch(batch_id)
Credits
mr.account()["credits_remaining"] # free call
Errors
Every API error raises MailRamboError with status, code and message:
from mailrambo import MailRamboError
try:
mr.verify(email)
except MailRamboError as e:
if e.code == "insufficient_credits":
... # top up at https://www.mailrambo.com/pricing
| status | code | meaning |
|---|---|---|
| 401 | invalid_api_key, api_key_revoked |
Check your key |
| 402 | insufficient_credits, subscription_inactive |
Top up or reactivate |
| 429 | rate_limited |
Retried automatically, then raised |
| 503 | provider_unavailable |
Retried automatically; charged credits are refunded |
Test mode
Create a mr_test_... key on the API Keys page. No credits are used, and the answer depends on the part before the @:
mr.verify("deliverable@example.com") # True, "mailbox_exists"
mr.verify("disposable@example.com") # False, "disposable"
mr.verify("catch_all@example.com") # False, "catch_all"
mr.verify("anything@example.com") # False, "mailbox_not_found"
Links
MIT License
Metadata
Release files for mailrambo 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mailrambo-0.2.0.tar.gz | 7.1 kB | Without provenance | Details for mailrambo-0.2.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mailrambo-0.2.0-py3-none-any.whl | Python 3 | none | any | Details for mailrambo-0.2.0-py3-none-any.whl |
Total release size: 14.1 kB
Release files / mailrambo-0.2.0.tar.gz
| Download URL | mailrambo-0.2.0.tar.gz |
|---|---|
| Size | 7.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c0d97381dffe29d4f19f0a6c5a877ffc3421ac83ed983b3976719a95d82d8f23
|
|
BLAKE2b-256 checksum How to use checksums |
e5d863ed4fb3b2c431fa0adc2361bb5d26ea438e1d6a08aa5e11e5503d7fc90d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.18
|
Release files / mailrambo-0.2.0-py3-none-any.whl
| Download URL | mailrambo-0.2.0-py3-none-any.whl |
|---|---|
| Size | 7.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
11bdff9c862d8dc422b2020996efc0ce88097e8f5a3c6428659bbae809f45edf
|
|
BLAKE2b-256 checksum How to use checksums |
a5c0fb90cd913ac599df7a7b2e35c4cae752735b9993150df9e70c01cee2e333
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.18
|
Security for mailrambo 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.