API Documentation
Welcome to the MailSniff API documentation. Learn how to integrate our email validation and rotation services into your applications.
Validate Service
Validate single emails or bulk lists with our powerful validation engine
Up to 500 email validations per API call with real-time results
Rotate Service
Generate email combinations from rotation elements
Up to 4 elements, max 100 combinations per call
Authentication
API Key Authentication
All API requests require authentication using your API key
Header Format
Authorization: Bearer YOUR_API_KEYKeep your API key secure
Never expose your API key in client-side code or public repositories
Rate Limits
Free Tier
500
validations per month
Pro Tier
25,000
validations per month
Business Tier
75,000
validations per month
Validate Service
POST /v1/validate
Validate single emails or bulk lists with comprehensive checks
Request Body
{
"emails": [
"user@example.com",
"test@domain.org"
]
}Limit: Maximum 500 emails per request
Response
{
"success": true,
"results": [
{
"email": "user@example.com",
"valid": true,
"deliverable": true,
"disposable": false,
"catch_all": false,
"score": 95
}
],
"total": 1,
"valid": 1,
"invalid": 0
}Validation Checks
Rotate Service
POST /v1/rotate
Generate email combinations from rotation elements
Request Body
{
"rotation_elements": ["John", "Doe", "gmail.com"]
}Limit: Maximum 4 rotation elements per request
Combinations: Maximum 100 combinations per request
Response
{
"success": true,
"combinations": [
"john.doe@gmail.com",
"j.doe@gmail.com",
"doe.john@gmail.com",
"jdoe@gmail.com"
],
"total_combinations": 4,
"elements_used": ["John", "Doe", "gmail.com"]
}Rotation Patterns
The service automatically generates common email patterns like:
- • firstname.lastname@domain.com
- • f.lastname@domain.com
- • firstname@domain.com
- • flastname@domain.com
Integrations
Zapier
Automate email validation in your workflows
Connect MailSniff to 5000+ apps with Zapier
View IntegrationMake
Build complex automation scenarios
Create sophisticated email validation workflows
View Integrationn8n
Open-source workflow automation
Self-hosted automation with MailSniff
View IntegrationCode Examples
Validate Emails
const validateEmails = async (emails) => {
const response = await fetch('https://api.mailsniff.com/v1/validate', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({ emails })
});
return await response.json();
};
// Usage
const result = await validateEmails([
'user@example.com',
'test@domain.org'
]);Testing
Try the API
Test our endpoints with your API key
Test Endpoint: Use our sandbox environment for testing
Base URL: https://api.mailsniff.com