mailsentry 1.0.0

Official Python SDK for the MailSentry email validation API

mailsentry

Official Python SDK for the MailSentry email validation API.

Installation

pip install mailsentry

Quick Start

from mailsentry import MailSentry

client = MailSentry(api_key="ms_live_your_key_here")

# Single verification
result = client.verify("[e-mail]")
print(result["score"], result["verdict"])

# Bulk verification
bulk = client.bulk_verify([
    "[e-mail]",
    "[e-mail]",
    "[e-mail]",
])
print(f"Validated {bulk['total']} emails")

# Get job details
job = client.get_bulk_job(bulk["id"])

# List recent jobs
jobs = client.list_bulk_jobs()

Configuration

client = MailSentry(
    api_key="ms_live_your_key_here",  # Required
    base_url="https://mailsentry.dev",  # Optional (default)
    timeout=30,  # Optional: request timeout in seconds (default: 30)
)

API Reference

verify(email) -> dict

Validates a single email address. Returns score (0-100), verdict, and detailed checks across 8 validation layers.

bulk_verify(emails, filename=None) -> dict

Validates multiple emails in one request. Batch size depends on your plan.

get_bulk_job(job_id) -> dict

Retrieves the full results of a bulk validation job.

list_bulk_jobs() -> list

Lists your 20 most recent bulk validation jobs.

Error Handling

from mailsentry import MailSentry, MailSentryError

try:
    result = client.verify("[e-mail]")
except MailSentryError as e:
    print(f"API error {e.status}: {e}")

Links

• Documentation
• Sign up — 1,000 free checks/month