getting started
Introduction
What the isBusinessEmail API answers, how a check works, and where to start: work vs personal email, disposable, relay, Google Workspace and Microsoft 365.
isBusinessEmail is a free API that answers one question for B2B products: is this signup a work email?
A work email lives on the company’s own custom domain ([email protected]). A personal email lives on a shared-domain provider, where one domain hands out inboxes to many unrelated people ([email protected], [email protected]). On top of that split, every check tells you:
- whether the address is disposable, a relay (Apple Hide My Email, Firefox Relay…) or on a blocklist
- whether the domain is education or government
- whether the company runs Google Workspace or Microsoft 365, and for Microsoft 365 the tenant ID, region and whether sign-in is federated (Okta, ADFS…)
- a recommendation (
allow,revieworblock) for the policy you pick, plus the reason codes behind it
curl -sG https://api.isbusinessemail.com/v1/check \
--data-urlencode "[email protected]"
That call needs no key: test.isbusinessemail.com addresses return fixed results and are never counted. See Test addresses.
How a check works
Each check runs through layers, cheapest first. Most requests finish in milliseconds from cache.
| Layer | What happens |
|---|---|
| Normalize | Trim, lowercase, Unicode-normalize, convert IDNs to punycode, strip +tag, find the registrable domain, flag role accounts, typos and lookalikes |
| Lists | Match against curated lists: shared providers, disposable, relay, education, government, business allowlist, blocklists |
| DNS | MX, SPF, DMARC, DKIM and verification TXT records of the registrable domain, over DNS-over-HTTPS |
| Workspace | Google Workspace and Microsoft 365 / Entra ID detection, including the tenant ID |
| Deep (optional) | Domain age via RDAP and a homepage check (deep=true) |
| Verdict | Rules first, then a confidence score; low confidence becomes unknown → review |
The full signal list is in Reason codes. The Workspace and Microsoft 365 logic is in Workspace detection.
What it does not do
/v1/check doesn’t verify individual mailboxes: it classifies the domain and the shape of the address, which is what decides whether a signup belongs to a company and whether your integrations will work. It never contacts a mail server, and we never use Microsoft GetCredentialType lookups or Google account probes anywhere.
If you need “will this exact mailbox accept mail?”, use /v1/verify. It asks the domain’s mail server over SMTP whether it accepts the address, tests for catch-all domains and hangs up before anything is sent. It is slower (seconds) and has its own daily cap, so use it before sending, not on every keystroke. For cleaning large lists in bulk, a dedicated list-cleaning service is still the better tool.
Free, with fair-use limits
Every account starts free with 100 checks a day. Paid plans raise the limits. See Rate limits.
Where to go next
- Quickstart: your first call in 30 seconds
- Authentication: secret and publishable keys
POST /v1/check: the main endpoint- Response fields: every field explained
- Block personal emails at signup: a UX guide that doesn’t lose good users
- API reference: generated from
/openapi.json