GuidesGetting Started with the Email Validation API

💡

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

• Documentation: https://campaignkit.cc/docs/