Interactive API Playground
Test the API Before You Build
Explore Mailthentic's email verification API endpoints, see response formats, and generate code — all from your browser.
Request
POST/api/verify/single
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
Demo uses our free DNS checker. Sign up for full SMTP verification via API.
Response
—// Click "Try It" to see a live response // or select an endpoint tab to see example responses { "email": "test@example.com", "domain": "example.com", "status": "deliverable_confirmed", "confidence_score": 95, "syntax_valid": true, "dns_valid": true, "mx_found": true, "mx_provider_type": "custom_smtp", "smtp_connectable": true, "mailbox_confirmed": true, "is_catch_all": false, "spf_present": true, "dmarc_present": true, "dkim_present": "found", "is_disposable": false, "reason": "Mailbox confirmed via SMTP.", "campaign_readiness": "safe" }
API Endpoints
Three endpoints to verify emails programmatically.
POST
/api/verify/single
Submit a single email for verification. Returns a job ID for polling. Costs 1 credit.
Auth: Bearer token or X-API-Key
Body: {"email": "user@example.com"}
Response: 202 Accepted
GET
/api/jobs/{job_id}/status
Poll job status. Returns "queued", "processing", or "done". No credits consumed.
Auth: Bearer token or X-API-Key
Response: 200 OK
GET
/api/jobs/{job_id}/results
Retrieve verification results once job is done. Returns full result object with all checks.
Auth: Bearer token or X-API-Key
Response: 200 OK
Verification Statuses
Every verified email returns one of these statuses.
| Status | Meaning | Safe to Send? |
|---|---|---|
deliverable_confirmed | Mailbox exists and accepts email | Yes |
deliverable_unconfirmed | Ambiguous provider (Gmail/M365) — DNS valid | Likely |
deliverable_unconfirmed_dns | DNS-only check passed (no SMTP) | Likely |
risky_catch_all | Domain accepts all addresses | Caution |
risky_missing_spf | MX found but no SPF record | Caution |
invalid | Mailbox rejected by server (550) | No |
invalid_domain | Domain doesn't exist or no MX | No |
invalid_syntax | Malformed email address | No |
unknown | Server didn't respond conclusively | Retry |
Ready to integrate?
Sign up free for 100 API credits. Generate your API key and start verifying in minutes.