Domain

Validate domain (POST)

post/domain

Response

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"
}