About this endpoint
What it does
Checks a single email address and returns a combined deliverability score based on syntax, MX, and disposable-email checks.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| String | Yes | The email address to evaluate. |
Response
Returns a JSON object with the top-level fields max (integer), email (string), level (string enum), score (integer), has_mx (boolean), disposable (boolean), and valid_syntax (boolean). The level field can be low, medium, or high, and score is constrained to values from 0 to 3.
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| max | Integer | No | Maximum possible score. |
| String | No | The email address that was evaluated. | |
| level | ENUM | No | Deliverability level. Allowed values: low, medium, high. |
| score | Integer | No | Deliverability score, from 0 to 3. |
| has_mx | Boolean | No | Indicates whether the domain has MX records. |
| disposable | Boolean | No | Indicates whether the email is from a disposable provider. |
| valid_syntax | Boolean | No | Indicates whether the email syntax is valid. |