Validate a list of email addresses

POST 
/email/validate

The Response

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 a temporary email address.
catchall	Email address has been identified as a common catch-all address.

Request

application/json

Body

required

emails string[]required

Responses

200

Validation results

application/json

Schema

Schema

creditsUsed integer

results

object[]

Array [

email string

result

object

syntax string

Possible values: [pass, fail, n/a, empty]

mx string

Possible values: [pass, fail, n/a, empty]

mailbox string

Possible values: [pass, fail, n/a, empty]

score integer

description string[]

classifier string

smtpResponse string

]

Example (from schema)

{
  "creditsUsed": 0,
  "results": [
    {
      "email": "string",
      "result": {
        "syntax": "pass",
        "mx": "pass",
        "mailbox": "pass",
        "score": 0,
        "description": [
          "string"
        ],
        "classifier": "string",
        "smtpResponse": "string"
      }
    }
  ]
}

400

Bad Request

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

402

Payment Required

application/json

Schema

Schema

error string

Example (from schema)

{
  "error": "string"
}

Loading...