v1

latestOpenAPI 3.1.0Proprietary2026-07-135410.8 KB

Validate email address

Check if an email address is from a disposable provider. Also validates format, DNS/MX records, and detects role accounts and free providers.

get/email/{email}

emailstring email required

Validation result

formatboolean required

Whether the email/domain has valid format

domainstring

The domain part of the email

disposableboolean

Whether the domain is a known disposable email provider

dnsboolean

Whether the domain has valid DNS/MX records

whitelistboolean

Whether the domain is whitelisted (trusted provider)

confidenceinteger

Confidence score (0-100) that the email is disposable. 50+ = disposable.

signalsstring[]

Detection signals that contributed to the confidence score

roleboolean

Whether the local part is a role address (info@, admin@, etc.)

freeboolean

Whether the domain is a free email provider (Gmail, Yahoo, etc.)

typo_suggestionstring nullable

Suggested correction if a likely typo was detected (e.g. gmial.com → gmail.com). Omitted when no suggestion is available.

requires_upgradestring[]

Features that require a higher tier (only present when denied features were requested)

{
  "domain": "mailinator.com",
  "typo_suggestion": "gmail.com"
}

All 5 operations