Email Inspector
Inspect email address details including format validation, MX record checks, and disposable email detection
Parameters
| name | in | type | required | description |
|---|---|---|---|---|
email |
query | string | required |
Request
Send your key in the X-API-Key header. More languages and patterns live on the
code examples page.
curl -s "https://apixies.io/api/v1/inspect-email?email=hello%40example.com" \ -H "X-API-Key: YOUR_API_KEY"
Response
The result sits under data in the standard envelope. See the
response format guide for errors and status codes.
returns
- data.is_disposable
- True for throwaway inbox domains.
- data.format_valid
- True when the address syntax is valid.
- data.mx_records_found
- True when the domain publishes MX records.
- data.mailbox_exists
- Result of a quick SMTP check against the mail server.
- data.is_role_based
- True for shared inboxes like info@ or support@.
- data.suggestion
- A likely fix for a mistyped domain, or null.
{
"status": "success",
"http_code": 200,
"code": "SUCCESS",
"message": "Email inspection successful",
"data": {
"email": "user@example.com",
"format_valid": true,
"domain_resolvable": true,
"mx_records_found": true,
"mailbox_exists": true,
"is_disposable": false,
"is_role_based": false,
"suggestion": null
}
}
Authentication and limits
This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.
Standard rate limits apply to this endpoint.
Common use cases
Clean signup forms in real-time
Validate email addresses at the point of entry to prevent typos, disposable emails, and invalid domains from entering your user database.
Reduce email bounce rates
Pre-validate your mailing list before sending campaigns. Check MX records and domain validity to remove undeliverable addresses and protect your sender reputation.
Fraud detection in e-commerce
Flag orders using disposable or suspicious email addresses. Combine with IP Geolocation for multi-signal fraud scoring.
related endpoints
guides
More documentation
Get a free API key
A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.