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.
{
"emails": [
"[email protected]",
"[email protected]",
"[email protected]",
"[email protected]"
]
}
Response body
{
"emails": {
"[email protected]": {
"status": "disposable"
},
"[email protected]": {
"status": "fake"
},
"[email protected]": {
"status": "alias"
},
"[email protected]": {
"status": "ok"
}
}
}
Available statuses
Status | Description |
---|---|
disposable | The email address is a temporary or disposable email address. |
fake | The email address is a fake email address. |
alias | The email address is using an alias, for example [email protected]. |
quota_exceeded | The email address couldn't be validated due to the quota exceeded. |
ok | The 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]"] }'