Email Validation Endpoint

The email endpoint allows you to check if an email address uses a disposable domain, along with additional details about the email and domain.

Endpoint

GET /email/{email}

Parameters

Parameter	Type	Required	Description
email	string	Yes	The email address to check (e.g., [email protected])

Request Example

curl -X GET "https://api.usercheck.com/email/[email protected]" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Success Response (200)

{
  "status": 200,
  "email": "[email protected]",
  "domain": "example.com",
  "mx": false,
  "disposable": false,
  "public_domain": false,
  "relay_domain": false,
  "alias": false,
  "role_account": 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 email) 429: Rate limit exceeded
email	string	The email address that was checked. This is the normalized form of the input email.
domain	string	The domain part of the email address that was extracted and analyzed.
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 email uses a temporary or disposable email domain. 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 email uses a public email service like Gmail, Yahoo Mail, Outlook, etc.
relay_domain	boolean	Indicates whether the email uses a domain that provides email forwarding services. Email forwarding domains redirect emails to another address, and can sometimes be used to hide the recipient's actual email provider.
alias	boolean	Indicates whether the email contains an alias (e.g., [email protected]). Email aliases allow a single mailbox to receive mail addressed to different variants of an address, which can be used for filtering or to create disposable addresses.
role_account	boolean	Indicates whether the email is a role account rather than a personal account. Role accounts (e.g., admin@, support@, info@) are typically shared by multiple people within an organization.
did_you_mean	string|null	Suggested correction if there's a likely typo in the email address. This is useful for catching common misspellings of popular domains or obvious typing errors. Returns null if no suggestion is available.
blocklisted	boolean	Indicates whether the email's 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 Email Format (400)

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

Rate Limit Exceeded (429)

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