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
Status | Description |
---|---|
disposable | The domain is a temporary or disposable domain. |
fake | The domain is a fake domain. |
quota_exceeded | The domain couldn't be validated due to the quota exceeded. |
ok | The 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]"] }'