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

email
required
string format: email
validate_domain
integer
0

When set to 1, perform MX and registry checks for the domain

skip_mx_validation
deprecated
number
nullable

This flag is deprecated and will be removed in a future release. Please use validate_domain instead.

Validation success response

object
id
required

Unique operation id

string
inbound
required

Incoming email address

string format: email
first_name
required

First name extracted from email address

string
last_name
required

Last name extracted from email address

string
normalized
required

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

string format: email
smtp_provider
required

SMTP provider for this email address

string
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

Whether the host domain contains valid MX records. Present only when validate_domain=1

boolean
domain_is_expired

Domain registration has expired. Present only when validate_domain=1

boolean
domain_is_expiring_soon

Domain expiration is within 30 days. Present only when validate_domain=1

boolean
domain_transfer_locked

Domain transfer is locked. Present only when validate_domain=1

boolean
domain_update_locked

Domain update is locked. Present only when validate_domain=1

boolean
domain_delete_locked

Domain delete is locked. Present only when validate_domain=1

boolean
domain_on_registry_hold

Domain is on registry hold. Present only when validate_domain=1

boolean
domain_pending_create

Domain has pending create status. Present only when validate_domain=1

boolean
domain_pending_delete

Domain has pending delete status. Present only when validate_domain=1

boolean
domain_pending_transfer

Domain has pending transfer status. Present only when validate_domain=1

boolean
domain_pending_update

Domain has pending update status. Present only when validate_domain=1

boolean
domain_is_registry_reserved

Domain is reserved by registry. Present only when validate_domain=1

boolean
domain_is_parking_nameserver

Domain uses parking nameserver. Present only when validate_domain=1

boolean
domain_is_deliverable

Overall domain deliverability flag. Present only when validate_domain=1

boolean
is_no_reply
required

Whether the address is a no-reply address

boolean
is_role_based
required

Whether the email address is role-based (e.g. admin@, info@, hr@)

boolean
has_irregular_pattern
required

Detects irregular or suspicious character patterns

boolean
has_uncommon_unicode
required

Detects uncommon or international Unicode symbols

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

Whether the host domain contains valid MX records. Present only when validate_domain=1

boolean
mx_records

List of MX records associated with the inbound domain. Present only when validate_domain=1

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
domain_age_days

Age of the domain in days since registration. Present only when validate_domain=1

number
root
required

Root domain from incoming email address

string
inbound
required

Incoming email address domain

string
disposable_sources

Array of disposable domain sources. This field is deprecated and will be removed in a future release.

Array<string>
provider

Generic registry provider label. Present only when validate_domain=1

string
nullable
provider_link

Public self link for the registry provider. Present only when validate_domain=1

string format: uri
nullable
registered_at

Registration date in ISO format. Present only when validate_domain=1

string
nullable
expires_at

Expiration date in ISO format. Present only when validate_domain=1

string
nullable
last_changed_at

Last registry update timestamp. Present only when validate_domain=1

string
nullable
last_checked_at

Timestamp when registry data was last checked. Present only when validate_domain=1

string
nullable
expires_in_days

Days until domain expiration. Present only when validate_domain=1

number
nullable
registrar_name

Registrar name. Present only when validate_domain=1

string
nullable
registrar_iana_id

Registrar IANA identifier. Present only when validate_domain=1

string
nullable
abuse_email

Abuse contact email. Present only when validate_domain=1

string format: email
nullable
abuse_phone

Abuse contact phone number. Present only when validate_domain=1

string
nullable
has_abuse_contact

Whether abuse contact information is available. Present only when validate_domain=1

boolean
epp_statuses

Registry status codes. Present only when validate_domain=1

Array<string>
dnssec_signed

Whether the domain is signed with DNSSEC. Present only when validate_domain=1

boolean
dnssec_ds_records_count

Number of DNSSEC DS records. Present only when validate_domain=1

number
dnssec_ds_records

DNSSEC DS records. Present only when validate_domain=1

Array<object>
object
keyTag
number
algorithm
number
digestType
number
nameservers

Nameserver hostnames. Present only when validate_domain=1

Array<string>
nameserver_count

Total number of nameservers. Present only when validate_domain=1

number
policy_registry_terms

Registry terms of service URL. Present only when validate_domain=1

string format: uri
nullable
policy_icann_epp_info

ICANN EPP information URL. Present only when validate_domain=1

string format: uri
nullable
policy_icann_wicf

ICANN Whois inaccuracy complaint form URL. Present only when validate_domain=1

string format: uri
nullable