Skip to content

Validate Email Address

GET
/emails/validate

Performs validation on incoming email address and returns whether it is a disposable email or not, along with other validations and metadata

Authorizations

Parameters

Query Parameters

email
required
string format: email

Responses

200

Validation success response

object
id
required

Unique operation id

string
inbound
required

Incoming email address

string format: email
normalized
required

Normalized email address based on provider without any labels. This will also remove any periods in gmail address.

string format: email
validations
required

A set of validations applied to incoming email for taking informative decision in your application

object
is_disposable
required

Whether the incoming email is disposable or not

boolean
has_label
required

Whether incoming username contain any label or not

boolean
is_subdomain
required

Whether incoming email address originated from a subdomain or not

boolean
has_valid_mx_records
required

Whether the host domain contains valid mx records or not

boolean
safe_to_send
required

Whether it is safe to send to incoming address. Send emails to address containing safe_to_send: true to reduce bounce rates

boolean
metadata
required

Metadata associated with incoming email address

object
username
required

Metadata about username in incoming email

object
inbound
required

Incoming user name

string
normalized
required

Normalized username based on provider without any labels. This will also remove any periods in gmail address.

string
has_label
required

Whether incoming username contain any label or not

boolean
label
required

Extracted label from incoming username

string
domain
required
object
is_disposable
required

Whether the incoming email is disposable or not

boolean
is_subdomain
required

Whether incoming email address originated from a subdomain or not

boolean
has_valid_mx_records
required

Whether the host domain contains valid mx records or not

boolean
root
required

Root domain from incoming email address

string
inbound
required

Incoming email address domain

string
mx_records
required

List of MX records associated with the inbound domain

Array<object>
object
priority
required

Each MX record has a priority, or a number to designate the order in which your domain name’s incoming mail servers receive your email messages

number
host
required

MX record host

string
disposable_sources
required

Array of disposable domain sources. If your domain is being detected as disposable, get it resolved on the given registries. For non-disposable domains this will return an empty array.

Array<string>