Menu

E-Mail Address Validation

Email Address Validation is available to Email API Pro and Premier level accounts only. Prior to upgrading your account to Pro or Premier, you will not see the option to create an Email Validation API key. An Email Validation API key is separate from and in addition to your other keys, including a Full Access API key.

Email Address Validation provides real-time detailed information on the validity of email addresses. You can integrate this validation process into your platform's signup form and customize the best use of email address validation for your use case.

You can use this API to:

  • Indicate to users that the address they have entered into a form is invalid.
  • Drop invalid email addresses from your database.
  • Suppress invalid email addresses from your sending to decrease your bounce rate.

You can learn more about enabling Email Validation in our Email Validation documentation.

You can also view your Email Validation results and metrics in the Validation section of the Twilio SendGrid App. Again, these settings are available only after upgrading your account to Pro or higher.

Validate an email

Validate an email

POST /validations/email

This endpoint allows you to validate an email address.

Authentication

  • API Key

Headers

Authorization
string
default: Bearer <<YOUR_API_KEY_HERE>>
required

Request Body

object
email
string

The email address that you want to validate.

required
source
string

A one-word classifier for where this validation originated.

{
  "email": "example@example.com",
  "source": "signup"
}

Responses

object
result
object
required
email
string

The email being validated

format: email
required
verdict
string

A generic classification of whether or not the email address is valid.

Allowed Values: Valid, Risky, Invalid
required
score
number

A numeric representation of the email validity.

required
local
string

The local part of the email address.

required
host
string

The domain of the email address.

format: hostname
required
suggestion
string

A suggested correction in the event of domain name typos (e.g., gmial.com)

checks
object

Granular checks for email address validity.

required
domain
object

Checks on the domain portion of the email address.

required
has_valid_address_syntax
boolean

Whether the email address syntax is valid.

required
has_mx_or_a_record
boolean

Whether the email has appropriate DNS records to deliver a message.

required
is_suspected_disposable_address
boolean

Whether the domain appears to be from a disposable email address service.

required
local_part
object

Checks on the local part of the email address.

required
is_suspected_role_address
boolean

Whether the local part of email appears to be a role or group (e.g., hr, admin)

required
additional
object

Additional checks on the email address.

required
has_known_bounces
boolean

WHether email sent to this address from your account has bounced.

required
has_suspected_bounces
boolean

Whether our model predicts that the email address might bounce.

required
source
string

The source of the validation, as per the API request.

ip_address
string

The IP address associated with this email.

required

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.