About this endpoint
What it does
Validates an email address and returns a JSON object with a data object containing validation signals and a score. The request sends an email in the body; the response reports syntax, deliverability-related checks, and an overall score.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| String | Yes | The email address to validate. Must be a valid email format. |
Response
Returns a JSON object with a data object. Inside data, score is an integer from 0 to 100, valid is a boolean, syntax is a boolean, reachable is an enum string, disposable is a boolean, mx_records is a boolean, role_based is a boolean, suggestion is a string, and free_provider is a boolean. Success responses are represented by this object shape.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| data | Object | No | Validation result object. |
| data.score | Integer | No | Score from 0 to 100. |
| data.valid | Boolean | No | True when syntax, MX, not disposable, and reachable is not "no". |
| data.syntax | Boolean | No | Indicates whether the email syntax is valid. |
| data.reachable | ENUM | No | Email reachability status. Allowed values: yes, no, unknown, risky. |
| data.disposable | Boolean | No | Indicates whether the email is disposable. |
| data.mx_records | Boolean | No | Indicates whether MX records were found. |
| data.role_based | Boolean | No | Indicates whether the email is role-based. |
| data.suggestion | String | No | Domain typo hint, such as a corrected domain suggestion. Omitted when empty. |
| data.free_provider | Boolean | No | Indicates whether the email uses a free provider. |