Email Address Validation
Email Address Validation is available to Email API Pro and Premier level accounts only. An Email Validation API key is required. See the Email Address Validation overview page for more information.
The Email Address Validation API provides detailed information about the validity of email addresses, which helps you create and maintain contact lists and reduce bounce rates.
This API provides two options:
- Real Time Email Address Validation: real time, detailed information on the validity of a single email address.
- Use this option to prompt users that they've provided an invalid email, prevent invalid emails from entering your database
- Bulk Email Address Validation: Asynchronous, bulk validation of up to one million email addresses.
- Use this option to help you remove invalid emails from your existing lists.
Real Time Email Address Validation - API Reference
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.
The optional source
parameter can be used identify the source of the email address. if you choose to integrate with multiple email address captures and want to be able to compare their results.
The source
must be a string, only using alphanumeric characters and spaces. For example:
{
"email": "email@example.com",
"source": "Newsletter Signup"
}
There is a limit of 50 sources. Sources are automatically deleted once the last validation to use that source falls off the 30 day window. You can continue to make validations without a source if you’ve hit the limit.
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.