MailOdds Python SDK

The official Python client for email validation, transactional sending, and deliverability monitoring through the MailOdds API.

Installation

pip install mailodds

Requires Python 3.9+.

Quick Start

import os
import mailodds

configuration = mailodds.Configuration(
    host="https://api.mailodds.com/v1",
    access_token=os.environ["MAILODDS_API_KEY"],
)

with mailodds.ApiClient(configuration) as client:
    api = mailodds.EmailValidationApi(client)
    request = mailodds.ValidateRequest(email="user@example.com")
    result = api.validate_email(request)

    print(f"Status: {result.result.status}, Action: {result.result.action}")

Error Handling

from mailodds.rest import ApiException

try:
    result = api.validate_email(request)
except ApiException as e:
    print(f"API error {e.status}: {e.body}")

ApiException includes status, body, headers, and reason for debugging.

MailOdds Platform

Features

• Context manager support - Use the ApiClient as a context manager for automatic resource cleanup
• Typed models - Every API request and response is a Python class with type hints for IDE autocompletion
• Flexible auth - Pass API keys via configuration or environment variables
• Bulk validation - Submit lists of up to 500,000 emails via JSON, file upload, or S3 presigned URL
• Structured error handling - ApiException carries HTTP status codes, response bodies, and headers for precise error recovery
• Full platform coverage - Access validation, sending, suppression lists, validation policies, and subscriber management from one package

Why MailOdds

MailOdds is a complete email deliverability platform built for developers. Every email validated or sent through MailOdds passes through 25+ real-time checks including syntax verification, DNS and MX validation, SMTP mailbox probing, disposable domain detection, and role account identification.

The platform maintains sub-200ms median response times for single validations, 99.9% API uptime, and processes bulk lists of up to 500,000 emails per job. MailOdds supports 11 language SDKs, an MCP server for AI agent integration, a CLI for local development, and a WordPress plugin for no-code deployments.

All email sending uses DKIM dual signing with automated key rotation, and the deliverability monitoring stack covers DMARC aggregate reports, blacklist surveillance across 80+ DNSBLs, and real-time sender health scoring.

API Reference

Full documentation is available at the MailOdds API Reference.

All URIs are relative to https://api.mailodds.com/v1.

Other SDKs

Resources

• Documentation
• Developer Quickstart
• All SDKs
• Security
• Guide: Email Authentication

License

MIT