Email API
Domain Status
Check whether a domain is webmail, disposable, catch-all, or gibberish before you trust its email addresses.
POST
$0.01/call/v1/email/domain-statusUsage
const res = await fetch('https://api.yepapi.com/v1/email/domain-status', {
method: 'POST',
headers: {
'x-api-key': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({ domain: 'stripe.com' }),
});
const { data } = await res.json();
console.log(data);curl -X POST https://api.yepapi.com/v1/email/domain-status \
-H "x-api-key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "stripe.com"}'Request Body
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
domain | string | Yes | Domain to check (e.g., stripe.com) | — |
Response
{
"data": {
"acceptAll": false,
"disposable": false,
"domain": "stripe.com",
"gibberish": false,
"webmail": false
},
"ok": true
}Response Fields
| Field | Type | Description |
|---|---|---|
ok | boolean | Whether the request succeeded |
data.domain | string | The domain that was checked |
data.webmail | boolean | Whether the domain is a webmail provider (e.g., Gmail, Yahoo) |
data.disposable | boolean | Whether the domain serves disposable/temporary email addresses |
data.acceptAll | boolean | Whether the domain accepts all incoming mail (catch-all), which makes per-mailbox verification unreliable |
data.gibberish | boolean | Whether the domain name looks like random characters |
Under the Hood
All four flags false indicates a normal corporate domain. Use this as a fast pre-filter before running per-address checks with the Email Verifier.