Previous Page

FREE API KEY

*Fields required.

Tutorials

Email Verify Tutorial

Overview

Email Verify is a real-time solution for verifying the status of a given email address.

Email Verify URI

The Email Verify URI accepts an email address and returns the verification value for the email address.

Required Information

The Email Verify URI requires you to have an Authorization Token. If you have not retrieved an Authorization Token yet, follow the Authorization Tutorial before continuing.

The Email Verify URI, like all of the solution URIs, also requires you to have an API Key. If you do not know your API Key, contact support to retrieve it. The API Key should be provided in the request header with the header attribute: x-api-key The Email Verify URI must be used with a POST request, where the request payload contains the email address to verify.

Request Headers
Header Attribute Header Value
x-api-key {your api key}
AuthorizationToken {your authorization token}
Content-Type application/json
Request Payload

The request payload for the Email Verify URI must contain the email attribute.

{ "email": "richard.young@fakeemail.com" }
cURL Example

To query the Email Verify URI, you can use one of the provided SDKs, a REST Client, or a simple cURL command. Below is an example of the cURL command for the example input information.

curl -X POST -H "Content-Type: application/json" -H "AuthorizationToken: {your_token}" -H "x-api-key: {your_key}" -H "Cache-Control: no-cache" -d '{ "email": "richard.young@fakeemail.com" }' "https://api.thedatagroup.com/v3/sync/verify/email"
Response Payload

The response payload for the Email Verify URI will contain the verification status of the email address provided in the request. The email address verification status can be one of the following values: UNKNOWN, VERIFIED, UNDELIEVERABLE, CATCH_ALL, DISTRIBUTION_GROUP, SPAM_TRAP, COMPLAINER, BOT, SUPPRESSED, and SEED_ACCOUNT.

{ "email": "richard.young@fakeemail.com", "status": "VERIFIED" }