Easy Email Verification for Python

Official Python client for the Easy Email Verification API: check whether email addresses exist and are safe to send to, one by one, in batches of 50 or as bulk lists of up to 16 MB. No email is sent to the addresses you verify.

• No dependencies (standard library only), Python 3.8+
• Type hints included
• Free sandbox key to test without an account or credits

Install

pip install easyemailverification

Quick start

from easyemailverification import Client, SANDBOX_API_KEY, decide

# Use SANDBOX_API_KEY to try it, or your own key (by default read from EEV_API_KEY)
eev = Client(SANDBOX_API_KEY)

result = eev.verify("valid@sandbox.easyemailverification.com")
print(result["result"], result["reason"], result["safe_to_send"])  # valid accepted_email True
print(decide(result))  # accept

Get your API key in the dashboard under API settings and keep it on the server, in the EEV_API_KEY environment variable.

Results

Every verification returns result (valid, invalid or unknown), a reason and risk signals:

decide(result) turns a result into "accept", "reject", "suggest" (show did_you_mean) or "review" (unknown, catch-all or disposable: your policy decides). Every result code is explained at easyemailverification.com/en-US/help/result-codes.

Batch: up to 50 addresses

for r in eev.verify_batch(["anna@example.com", "mark@gmial.com"]):
    print(r["email"], decide(r))

Bulk lists

For files with thousands of addresses (TXT or CSV, one address per line, up to 16 MB). The account needs enough credits for every address. Bulk does not work with the sandbox key.

job = eev.bulk.upload("leads.csv")          # a path, or bytes with the contents
done = eev.bulk.wait(job["list_id"])        # polls until completed (or failed)
if done["status"] == "completed":
    csv_text = eev.bulk.download(job["list_id"])  # Email,Result,Reason,...,IsSafeToSend,DidYouMean,...
eev.bulk.list()                             # all jobs of the account
eev.bulk.delete(job["list_id"])             # results are also deleted after 30 days

Credits

print(eev.credits()["credits_remaining"])  # free call

Each verified address uses one credit; unknown results do not. The free plan includes 50 verifications a day. See pricing.

Errors

API errors raise EEVError with the HTTP status and the API message:

from easyemailverification import EEVError

try:
    eev.verify("someone@example.com")
except EEVError as e:
    if e.status == 402:
        ...  # no credits left

Do not retry verifications in a tight loop: a request that timed out may already have used a credit.

Sandbox addresses

With SANDBOX_API_KEY, these addresses return fixed answers: valid@, invalid@, unknown@, disposable@, catchall@, role@, quota@ (402) and ratelimit@ (429) at sandbox.easyemailverification.com, plus typo@gmial.com (did you mean). Sandbox calls are limited to 60 per minute per IP.

Links

• Email verification API and API reference
• How to validate an email address in Python
• OpenAPI specification
• MCP server for AI assistants
• Support: support@easyemailverification.com

License

MIT