Skip to content
GET /api/v1/inspect-email

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 Email

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.
example response 200
{
    "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.

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.

cookies

We use analytics cookies to see how the site gets used. Nothing loads until you accept. Privacy policy