Validate domains

This endpoint validates the domains passed in the request body.

Endpoint

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

Request body

Important:

Since this endpoint validates domains in bulk, you might reach your quota prematurely. For example you have 10 validations left, but you send 15 domains for validation. In this case the first 10 domains will be validated and the remaining 5 domains 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.

{
  "domains": [
    "disposable.com",
    "fake.com",
    "valididentities.com"
  ]
}

Response body

{
  "domains": {
    "disposable.com": {
      "status": "disposable"
    },
    "fake.com": {
      "status": "fake"
    },
    "valididentities.com": {
      "status": "ok"
    }
  }
}

Available statuses

StatusDescription
disposableThe domain is a temporary or disposable domain.
fakeThe domain is a fake domain.
quota_exceededThe domain couldn't be validated due to the quota exceeded.
okThe domain seems safe.

Example

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