Skip to content
View Markdown

Domain Check

Check a bare domain for disposable-provider indicators and mail DNS. Use the email endpoint for checks against known disposable accounts and plus-alias patterns.

Endpoints

GET/api/domain/{domain}
POST/api/domain

GET request

bash
curl https://disify.com/api/domain/disposable-inbox.test

POST request

bash
curl -X POST https://disify.com/api/domain \
     -d "domain=disposable-inbox.test"
python
import requests

response = requests.post("https://disify.com/api/domain", data={
    "domain": "disposable-inbox.test"
})
print(response.json())
javascript
const response = await fetch("https://disify.com/api/domain", {
  method: "POST",
  headers: { "Content-Type": "application/x-www-form-urlencoded" },
  body: new URLSearchParams({ domain: "disposable-inbox.test" })
});
const data = await response.json();

These snippets show request encoding. Use the Quick Start for timeout, HTTP status, and response checks before making a validation decision.

POST parameters

ParameterTypeDescription
domainstringThe domain name to validate

Response

json
{
  "format": true,
  "domain": "disposable-inbox.test",
  "disposable": true,
  "dns": false,
  "whitelist": false,
  "confidence": 100,
  "signals": ["keyword_match", "no_mx_records"],
  "domain_info": { "tld": "test", "is_subdomain": false, "parent_domain": null },
  "role": false,
  "free": false
}

Pass a bare domain

Send example.com, not [email protected] or a URL. This endpoint does not extract a domain from a full address. role is always false in domain mode.

See Response Fields for the full field reference.

Free disposable email detection API · Terms · Privacy