Check an email address, domain or website URL

Pass exactly one of email, domain or url. Prefer POST so addresses do not end up in URLs and logs. Test addresses under test.isbusinessemail.com need no key.

get/v1/check

Request

  • Base URL: https://api.isbusinessemail.com
  • URL: https://api.isbusinessemail.com/v1/check
  • Auth: one of:
    • HTTP bearer
    • API key in header X-API-Key

Query parameters

emailstring
domainstring
urlstring

A website address such as https://www.acme.io/pricing; its host is checked.

policy'b2b' | 'strict' | 'lenient'
deepboolean

Domain age (RDAP) + homepage check. Counts as 5.

workspaceboolean

false skips the Microsoft tenant lookup (faster; microsoft_365 tenant fields stay null).

Response

Verdict

emailstring nullable

The address as sent (null for domain and URL checks).

urlstring

Only for URL checks: the website address as sent. Its host (without www.) is the checked domain.

normalized_emailstring nullable

Lowercased, IDN-normalised, +tag removed.

domainstring nullable required
is_businessboolean required

True for business, education and government.

category'business' | 'personal' | 'disposable' | 'relay' | 'education' | 'government' | 'invalid' | 'unknown' required
confidencenumber required
recommendation'allow' | 'review' | 'block' required
policy'b2b' | 'strict' | 'lenient'
is_free_providerboolean
is_disposableboolean
is_relayboolean
is_role_accountboolean
is_blockedboolean
is_new_domainboolean
is_lookalikeboolean
has_subaddressboolean
did_you_meanstring nullable

Suggested domain for a likely typo.

domain_age_daysinteger nullable
reasonsstring[] required

See https://isbusinessemail.com/docs/reason-codes

degradedboolean

DNS was unavailable; the verdict is from lists only.

cachedboolean
took_msinteger
request_idstring

Example response

{
  "shared_inbox": {
    "match": "support"
  },
  "group": {
    "match": "team"
  },
  "mail": {
    "provider": "google_workspace"
  },
  "workspace": {
    "microsoft_365": {
      "identity_provider": "okta"
    }
  },
  "mailbox": {
    "provider": "google_workspace",
    "gateway": "proofpoint"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.