Overview
This guide will help you validate customer email addresses individually via our API service. Our service will indicate if the email is valid, any underlying details, and even provide suggestions if a typo is detected in a major vendors names (ex: gmail).
To access our API documentation, please click here
Base URL
Body
There are two parameters allowed within the request Body:
order_id - this is optional, but recommended if you're validating an eCommerce based order.
customer_email
Responses
Based on the email address provided, our API will respond with a series of results including an in-depth overview of the type of email the customer has, and relevant quality score. The below table provides a description of each of these values:
Name | Example | Description |
Validation Code | 1000 | Internal value related to the validation text. |
Validation Text | The provided email address is valid. | Detailed description of the related validation code. |
Email Suggestion | If a typo was detected in a major email vendor name, we will correct and offer a suggestion. | |
Quality | Deliverable | Whether or not the email is considered deliverable. |
Role | support | IF the entered email is linked to a role, versus a person. |
Disposable | true | If the entered email belongs to a well known "throwaway" or "temp" email service. |
Free Email | true | If the entered email belongs to a free email provider, such as AOL, etc. |
Details | DNS Error | When an issue is detected with an email address, we will provide a detailed overview of the problem. |
Have a Question?
Be sure to ask our team via the Live Chat button on the bottom right, or contact your account manager directly via email / phone to learn more.