Use the Check API to validate emails and domains in your applications.
This endpoint is experimental and the response format is expected to change. It is recommended to handle the response accordingly until the format is finalized.
To use the Check API, you need to make a GET request to the endpoint with the email or domain you want to check. You also need to provide the API key in the request header. You can refer here to see how to authenticate your requests.
GET /check/:input| Parameter | Type | Description |
|---|---|---|
| input | String | The domain or email address to validate |
| Parameter | Type | Default | Description |
|---|---|---|---|
| disposable | Boolean | false | Allow disposable email addresses |
| roleAccount | Boolean | true | Allow role accounts (e.g., admin@, support@) |
| alias | Boolean | true | Allow alias accounts (containing + symbol) |
| publicProviders | Boolean | true | Allow public email providers (gmail, hotmail, etc.) |
| mxRecord | Boolean | false | Validate MX record (reject if not valid) |
The API returns a JSON object with information about the validation. For most cases, you can use the allowed field to determine if the email is valid.
{
"data": {
"email": "test@example.com",
"domain": "example.com",
"allowed": true
},
"meta": {
"allowedConfig": {
"disposable": false,
"roleAccount": true,
"alias": true,
"publicProviders": true,
"mxRecord": false
},
"checks": {
"isDisposable": false,
"isRoleAccount": false,
"hasAlias": false,
"isPublicProvider": false,
"hasValidMxRecords": true
}
}
}If the request is invalid, the API will return an error response:
{
"error": {
"code": "BAD_REQUEST",
"message": "Invalid domain or email"
}
}
Unfake
You can focus on what matters for your business instead of worrying about temp mail and spam detection. With our API, your systems are protected from fake email addresses.
Made with ❤️ in India.
Copyright © 2025 Unfake | All rights reserved.