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
POST /v3/validations/email
Base url: https://api.sendgrid.com
This endpoint allows you to validate an email address.
Authentication
- API Key
Headers
Request Body
The email address that you want to validate.
A one-word classifier for where this validation originated.
{
"email": "example@example.com",
"source": "signup"
}
Responses
The email being validated
format: emailA generic classification of whether or not the email address is valid.
Allowed Values: Valid, Risky, InvalidA numeric representation of the email validity.
The local part of the email address.
The domain of the email address.
format: hostnameA suggested correction in the event of domain name typos (e.g., gmial.com)
Granular checks for email address validity.
Checks on the domain portion of the email address.
Whether the email address syntax is valid.
Whether the email has appropriate DNS records to deliver a message.
Whether the domain appears to be from a disposable email address service.
Checks on the local part of the email address.
Whether the local part of email appears to be a role or group (e.g., hr, admin)
Additional checks on the email address.
WHether email sent to this address from your account has bounced.
Whether our model predicts that the email address might bounce.
The source of the validation, as per the API request.
The IP address associated with this email.
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.