Validate emails

This endpoint validates the email addresses passed in the request body.

Endpoint

POST https://api.valididentities.com/emails/validate

Request body

Important:

Since this endpoint validates email addresses in bulk, you might reach your quota prematurely. For example you have 10 validations left, but you send 15 emails for validation. In this case the first 10 emails will be validated and the remaining 5 emails will have quota_exceeded status.

If you have 0 validations left and you invoke this endpoint, it will respond with 429 Too Many Requests according to Rate Limits.

Response body

{
  "emails": {
    "[email protected]": {
      "status": "disposable"
    },
    "[email protected]": {
      "status": "fake"
    },
    "[email protected]": {
      "status": "alias"
    },
    "[email protected]": {
      "status": "ok"
    }
  }
}

Available statuses

StatusDescription
disposableThe email address is a temporary or disposable email address.
fakeThe email address is a fake email address.
aliasThe email address is using an alias, for example [email protected].
quota_exceededThe email address couldn't be validated due to the quota exceeded.
okThe email address seems safe.

Example

curl 'https://api.valididentities.com/emails/validate' \
  --header 'Authorization: Bearer {API_KEY}' \
  --header 'Content-Type: application/json' \
  --data '{ "domains": ["[email protected]"] }'