CampaignKit

Getting Started with the Email Validation API

Marco R. -
💡
You need to signup for an account to get access to the Email Validation API.

The Email Validation API allows you to validate a list of email addresses and to retrieve detailed validation results.

Getting started

Start with a simple validate query for a list of email addresses. Use the API key from your account.

curl --request POST \
 --url 'https://api.campaignkit.cc/v1/email/validate' \
 --header 'Authorization: Bearer <<your API key>>' \
 --data '{ "emails": ["a348sf@gmail.com"] }'

This validates a single email address and returns the result.

Response

The Email Validation API returns a result object for each email address in the request. 

{
    "results": [
        {
            "email": "a348sf@gmail.com",
            "result": {
                "syntax": "pass",
                "mx": "pass",
                "mailbox": "fail",
                "score": 0,
                "description": [
                    "mailbox"
                ]
            }
        }
    ]
}

Can I use the email address?

If the score is greater than 2 you can use the email address and emails will most likely not bounce.

A score of 2 identifies email addresses that will be delivered, but the email address is a SPAM Trap or temporary email address.  

Result

Element Values Description
syntax pass, fail Email syntax check result.
mx pass, fail MX record lookup result. Checks if the domain exists and publishes information about an email server
mailbox pass, fail, n/a Mailbox check result. Checks if the email server can be reached and tries to verify if the email address exists. Returns n/a if the mailbox cannot be verified.

Score

The score range goes from 0 to 10 where 0 identifies an email that is guaranteed to not be usable and 10 means that all checks passed and emails will be delivered to a personal email address.

Score Description
0 Email will bounce
2 Email can be used, but looks like a SPAM Trap or temporary email address.
9 Email looks good, but mailbox couldn't be verified.
10 Email address passed all checks and emails will be accepted by the server.

Description

The description contains additional information about the check results and resulting score.

Value Description
syntax Email syntax check failed.
domain Domain doesn't exist or no MX record configured.
mailbox Mailbox check returned unknown recipient.
verifyRejected Mailbox could not be verified. The recipient's mail server rejected verification attempts
blacklist Email address has been detected in local blacklist
disposable Email address or domain has been detected as temporary email address.
catchall Email address has been identified as a common catch all address.

References