Domain Validation Endpoint

The domain endpoint allows you to check if a domain is used for disposable email addresses, along with additional details about the domain.

Endpoint

GET /domain/{domain}

Parameters

Parameter	Type	Required	Description
domain	string	Yes	The domain to check (e.g., example.com)

Request Example

curl -X GET "https://api.usercheck.com/domain/example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Success Response (200)

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

Response Fields

Field	Type	Description
status	integer	HTTP status code indicating the result of the API request. 200: Successful request 400: Invalid input (malformed domain) 429: Rate limit exceeded
domain	string	The domain that was checked. This is the normalized form of the input domain.
mx	boolean	Indicates whether the domain has valid MX (Mail Exchange) records. A value of true means the domain is configured to receive email.
disposable	boolean	Indicates whether the domain is from a temporary or disposable email provider. These domains allow users to create temporary email addresses that typically expire after a short period, and are commonly used to bypass verification systems.
public_domain	boolean	Indicates whether the domain is a public email service like Gmail, Yahoo Mail, Outlook, etc.
relay_domain	boolean	Indicates whether the domain is used for email forwarding services. Email forwarding domains redirect emails to another address, and can sometimes be used to hide the recipient's actual email provider.
did_you_mean	string|null	Suggested correction if there's a likely typo in the domain name. This is useful for catching common misspellings of popular domains. Returns null if no suggestion is available.
blocklisted	boolean	Indicates whether the domain is on your account's custom blocklist. This feature is only available on Pro plans and allows you to maintain your own list of domains that you want to block.
spam	boolean	Indicates whether the domain is associated with spam or other abusive activities. This property leverages our extensive data intelligence to identify domains that may appear legitimate but exhibit suspicious patterns or have been flagged in our system. It serves as a supplementary signal to the disposable and blocklist checks.

Error Responses

Invalid Domain Format (400)

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

Rate Limit Exceeded (429)

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