Domain

Check if a domain is used for disposable email addresses

Returns information about whether a domain is used for disposable email addresses, including MX record presence, public email service status, and more.

GEThttps://api.usercheck.com/domain/{domain}

Authorization

BearerAuthApiKeyQuery

Path parameters

domain*string

The domain to check

Example: "example.com"

Response

200400429

Domain check successful

Body

application/json

statusenum

HTTP status code

Example: 200

200400429

domainstring

The domain that was checked

Example: "example.com"

mxboolean

Whether the domain has MX records

Example: false

disposableboolean

Whether the domain is a disposable email domain

Example: false

public_domainboolean

Whether the domain is a public email service (gmail.com, yahoo.com, etc)

Example: false

relay_domainboolean

Whether the domain is used for email forwarding services

Example: false

did_you_meannullable string

Suggested correction if there's a likely typo

blocklistedboolean

Whether the domain is blocklisted (Pro plan only)

Example: false

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.usercheck.com/domain/{domain}', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer <token>"
    },
});
const data = await response.json();

Response

200400429

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