About this endpoint
What it does
Verifies an email address's syntax and deliverability, and flags disposable, role-based, free-provider, and catch-all addresses. Also checks MX records, domain age, and Gravatar presence, returning a fraud risk score and recommendation.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| String | Yes | Email address to verify. Must be a valid email format. |
Response
Returns a JSON object with the request status and an EMAIL object covering syntax, deliverability, domain and MX checks, and an overall risk score with a recommendation.
| Attribute | Type | Description |
|---|---|---|
| success | Boolean | Whether the request succeeded. |
| code | Integer | Numeric response code. |
| Object | Email verification result. | |
| EMAIL.email / normalized | String | The address as submitted and normalized. |
| EMAIL.user / domain | String | Local part and domain of the address. |
| EMAIL.valid | Boolean | Overall validity (syntax + deliverability). |
| EMAIL.is_valid_syntax | Boolean | Whether the address is syntactically valid. |
| EMAIL.is_deliverable / deliverability | Boolean/String | Whether mail can be delivered, and the deliverability status. |
| EMAIL.is_disposable | Boolean | Whether it's from a disposable/temporary email provider. |
| EMAIL.is_role | Boolean | Whether it's a role address (e.g. info@, support@). |
| EMAIL.is_free_provider | Boolean | Whether it's from a free consumer email provider. |
| EMAIL.is_catch_all / catch_all | Boolean/Object | Whether the domain accepts all addresses (catch-all). |
| EMAIL.mx | Object | MX record lookup — found, provider, reputability, records. |
| EMAIL.gravatar | Object | Whether a Gravatar profile exists for this address. |
| EMAIL.domain_age | Object | Domain registration age and date. |
| EMAIL.breaches | Object | Known data-breach exposure, where checked. |
| EMAIL.reputation | Object | External reputation signal, where checked. |
| EMAIL.risk_score | Number | Overall fraud risk score. |
| EMAIL.risk_level | String | low, medium, or high. |
| EMAIL.recommendation | String | accept, review, or reject. |
| EMAIL.summary | String | Plain-language explanation of the result. |
| EMAIL.reasons | Array | Codes/messages explaining the risk drivers. |



