Email

Was this helpful?

Check if an email address is disposable

Returns information about whether an email address uses a disposable domain, along with additional details about the email and domain.

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

Authorization

Path parameters

email*string

The email address to check

Example: "user@example.com"

Response

Email check successful

Body

statusenum

HTTP status code

Example: 200

200400429

emailstring

The email address that was checked

Example: "user@example.com"

domainstring

The domain part of the email address

Example: "example.com"

mxboolean

Whether the domain has MX records

Example: false

disposableboolean

Whether the email uses a disposable email domain

Example: false

public_domainboolean

Whether the domain is a public email service

Example: false

relay_domainboolean

Whether the domain is used for email forwarding services

Example: false

aliasboolean

Whether the email contains an alias (e.g., user+alias@example.com)

Example: false

role_accountboolean

Whether the email is a role account (e.g., admin@, support@)

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

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

Response

{
  "status": 200,
  "email": "user@example.com",
  "domain": "example.com",
  "mx": false,
  "disposable": false,
  "public_domain": false,
  "relay_domain": false,
  "alias": false,
  "role_account": false,
  "did_you_mean": null,
  "blocklisted": false
}