About this endpoint
What it does
Checks whether an email address appears to be disposable and returns a confidence score plus the underlying signals used to compute it.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| String | Yes | Email address to analyze. Must be in email format. |
Response
Returns a JSON object with a data object field. data contains signals and confidence_score; signals is an object with several boolean and numeric indicators, and confidence_score is a floating-point disposable-likelihood score from 0 to 1.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| data | Object | No | Response wrapper containing the detection result. |
| data.signals | Object | No | Signal object with the individual indicators used to assess disposability. |
| data.signals.blocklist | Boolean | No | Whether the domain appears on a blocklist. |
| data.signals.disposable_mx | Boolean | No | Whether the domain uses disposable MX infrastructure. |
| data.signals.entropy_score | Number | No | Shannon entropy of the domain label, as a float from 0 to 1. |
| data.signals.has_mx_records | Boolean | No | Whether the domain has MX records. |
| data.signals.domain_age_days | Integer | No | Days since registration via RDAP; -1 when unavailable. |
| data.confidence_score | Number | No | Aggregated disposable likelihood score, as a float from 0 to 1. |