Get your API key
Create an account or use the sandbox to test immediately
Free tier available
1,000 trial credits + 50/month free tier
Use test mode
Try the API with predictable responses
mo_test_your_api_key Install the SDK
Choose your language and add the dependency
Make your first API call
Pick an API, copy the code, and run it. Test mode works immediately.
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', ... }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:
{
"email": "test@deliverable.mailodds.com",
"status": "valid",
"action": "accept",
"test_mode": true
}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
- Verify a sending domain (DKIM + SPF + DMARC)
- Set up double opt-in for subscriber lists
Explore more features
Sending Domains
Verify DKIM, SPF, and DMARC for your domains
Email Sending
Transactional and campaign delivery with pre-send validation
Subscriber Lists
Double opt-in management with consent tracking
Bulk Validation
Validate thousands of emails via file upload or API
Webhooks
Real-time delivery, bounce, and completion events
Validation Policies
Customize rules for what counts as valid
Need the full API reference?
Every endpoint, response field, error code, webhook contract, and retry pattern in one page.
Need a different language?
11 official SDKs: Python, TypeScript, PHP, Java, Go, C#, Ruby, Kotlin, Rust, Swift, and Dart.
Test with Postman
Download our official Postman collection to explore all API endpoints with pre-configured auth and example payloads.
Prefer no-code?
Connect MailOdds to Zapier, Make, n8n, and 5,000+ apps without writing code.
APIs Beyond Validation
Validate, send, and track with one API key. No stitching together separate providers.
Sending API
Transactional and campaign delivery with built-in validation and dual DKIM signing.
POST /v1/deliver Subscriber Lists
Double opt-in subscriber management with consent proof and suppression enforcement.
POST /v1/subscribe/:list_id Sending Domains
DNS verification with identity scoring across DKIM, SPF, DMARC, MX, and return path.
POST /v1/sending-domainsQuestions? Contact us or check the documentation.