Getting 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/

GuidesGetting Started with the Email Validation API