MailOdds
Developer Quick Start

Validate emails in 5 minutes

Official SDKs for 11 languages, predictable test mode, and debugging tools. Ship with confidence.

1

Get your API key

Create an account or use the sandbox to test immediately

Free tier available

1,000 free validations per month

Create Free Account

Use test mode

Try the API with predictable responses

$ mo_test_your_api_key
2

Install the SDK

Choose your language and add the dependency

npm install @mailodds/sdk
View source on GitHub:
3

Run your first validation

Copy this code and run it - it works immediately with test mode

TYPESCRIPT First validation
import { Configuration, EmailValidationApi } from '@mailodds/sdk';

const config = new Configuration({
  basePath: 'https://api.mailodds.com',
  headers: { 'Authorization': 'Bearer mo_test_your_api_key' }
});

const api = new EmailValidationApi(config);
const result = await api.validateEmail({
  validateRequest: { email: 'test@deliverable.mailodds.com' }
});

console.log(result);
// { status: 'valid', action: 'accept', ... }
4

Test different scenarios

Use test domains with mo_test_ keys to get predictable responses without consuming credits

Click a test domain to see the expected response:

// Expected response
{
  "email": "test@deliverable.mailodds.com",
  "status": "valid",
  "action": "accept",
  "test_mode": true
}
5

Go to production

Complete this checklist before going live

  • Switch to live API key (mo_live_xxx)
  • Add error handling for rate limits
  • Configure webhook endpoint for bulk jobs
  • Review validation policies for your use case

Explore more features

Need the full API reference?

Every endpoint, response field, error code, webhook contract, and retry pattern -- all in one page.

API Documentation

Need a different language?

11 official SDKs: Python, TypeScript, PHP, Java, Go, C#, Ruby, Kotlin, Rust, Swift, and Dart.

All SDKs

Prefer no-code?

Connect MailOdds to Zapier, Make, n8n, and 5,000+ apps without writing code.

View Integrations

Questions? Contact us or check the documentation.