Domain endpoint

Check a domain

GET https://api.usercheck.com/domain/example.com

Check the domain example.com.

200 The domain format is valid

{
    "status": 200,
    "domain": "example.com",
    "mx": false,
    "disposable": false,
    "public_domain": false,
    "relay_domain": false,
    "did_you_mean": null,
    "blocklisted": false
}

400: Bad Request The domain format is invalid

{
    "status": 400,
    "error": "The domain is invalid."
}

429: Too Many Requests Rate limit exceeded

{
    "status": 429,
    "error": "Too many requests"
}

Keys	Values
status	The status of the request. Possibles values are: 200 The request is successful 400 The request is invalid 429 The rate limit is exceeded
domain	The domain you sent
mx	Whether or not the domain has MX records
disposable	Whether or not the domain is disposable
public_domain	Whether or not the domain is from a public email provider (e.g. Gmail, Yahoo, Outlook...)
relay_domain	Whether the domain is from an email forwarding service (e.g. Firefox Relay, SimpleLogin...)
did_you_mean	Returns a suggested valid domain based on a list of the most popular email providers. Returns NULL if the domain is already a valid domain, or if there's no close result.
blocklisted	Whether the domain is blocklisted (Pro plan only)
error	The description of the error, if the status is different from 200