Frequently Asked Questions

Everything you need to know about CleanMail email verification API.

Getting Started
How do I get an API key?
Sign up for a free account at cleanmail.dev. Your API key will be displayed on your dashboard immediately after registration.
How do I use the API?
Include your API key in the X-API-Key header when making requests: 
curl -X POST https://cleanmail.dev/api/verify \
  -H "X-API-Key: your_api_key" \
  -d '{"email": "user@example.com"}'
Is there a free trial?
Yes! The Free plan includes 100 verifications per day forever. No credit card required.
Features
What does the verification check?
Our API checks:
  • Syntax validation
  • MX record existence
  • SMTP connection and mailbox existence
  • Disposable email detection
  • Role account detection (info@, support@, etc.)
  • Spam trap detection
  • Free provider detection (Gmail, Yahoo, etc.)
What are webhooks?
Webhooks let you receive verification results asynchronously. When you submit a verification with a webhookUrl, we'll POST the result to your URL when processing completes. This is perfect for high-volume applications.
What's the difference between sync and async verification?
Sync: You wait for the result (typically 2-5 seconds). Best for low-volume use.
Async (Webhooks): You get a request ID immediately, then receive results at your webhook URL. Best for high-volume or real-time applications.
What risk levels mean
  • Low: Safe to email, deliverable mailbox
  • Medium: Some risk signals detected
  • High: Spam trap, known bounces, or suspicious patterns
Pricing & Plans
How much does it cost?
PlanPriceDaily Limit
Free$0100
Starter$9/mo500
Pro$29/mo2,000
Business$79/mo10,000
View full pricing details →
Do you offer annual discounts?
Yes! Annual plans save you 2 months (effectively 10 months for the price of 12).
What happens if I exceed my daily limit?
You'll receive a 429 error (Rate Limited). Upgrade your plan or wait until midnight UTC for your limit to reset.
Technical
What's the API response time?
Most verifications complete in 2-5 seconds. Complex cases may take up to 10 seconds. Use webhooks for better UX in high-volume scenarios.
Is the API HTTPS only?
Yes, all API requests must use HTTPS. HTTP requests will be rejected.
What response format does the API return?
JSON responses with camelCase fields: 
{
  "email": "user@example.com",
  "valid": true,
  "reason": "deliverable",
  "risk": "low",
  "mxFound": true,
  "delivery": "deliverable"
}
Can I test without an API key?
Yes! Use the demo endpoint: POST /api/demo/verify (no auth required). Limited to 10 requests per minute.
Support
How do I get help?
Email us at CleanMail.service@gmail.com for technical support or sales inquiries.
Do you offer custom plans?
For high-volume needs (100K+/day), contact us for enterprise pricing and dedicated support.

Still have questions?

Contact us at CleanMail.service@gmail.com