GET
$0.14 default
/checkDescription
Validate a single email address: format, MX, SMTP mailbox check, and disposable/role/free classification with a deliverability score.
Pricing
$0.14 default
Parameters
{
"email": {
"description": "Email address to validate, e.g. support@apple.com",
"required": true,
"type": "string"
},
"format": {
"description": "Set 1 for pretty-printed JSON.",
"required": false,
"type": "integer"
},
"smtp": {
"description": "Set 0 to skip the live SMTP mailbox check (default 1).",
"required": false,
"type": "integer"
}
}Response schema
{
"properties": {
"catch_all": {
"type": [
"boolean",
"null"
]
},
"did_you_mean": {
"type": "string"
},
"disposable": {
"type": "boolean"
},
"domain": {
"type": "string"
},
"email": {
"type": "string"
},
"format_valid": {
"type": "boolean"
},
"free": {
"type": "boolean"
},
"mx_found": {
"type": "boolean"
},
"role": {
"type": "boolean"
},
"score": {
"type": "number"
},
"smtp_check": {
"type": "boolean"
},
"user": {
"type": "string"
}
},
"type": "object"
}Example response
{
"catch_all": null,
"did_you_mean": "",
"disposable": false,
"domain": "apple.com",
"email": "support@apple.com",
"format_valid": true,
"free": false,
"mx_found": true,
"role": true,
"score": 0.8,
"smtp_check": true,
"user": "support"
}