Is there an API that tells disposable, free and alias emails apart?
Yes. Disban classifies the domain of an email address into one of six categories: disposable (throwaway inboxes such as Yopmail or Mailinator), free (permanent free providers such as Gmail, Outlook and Proton Mail), alias (privacy relays such as SimpleLogin, Firefox Relay and Apple Hide My Email), testing (developer test inboxes such as Mailosaur), parked, or unknown. It also reports whether the domain can receive mail at all. You can try it with no key or signup.
curl https://disban.io/api/v1/check/yopmail.com
# {"domain":"yopmail.com","category":"disposable","disposable":true,"mail_routing":"routable"}
curl https://disban.io/api/v1/check/gmail.com
# {"domain":"gmail.com","category":"free","disposable":false,"mail_routing":"routable"}Why the three are different signals
A disposable inbox is public or short-lived: anyone can read it, and it will not be there next month, so it suits people who want a free trial without an account. A free provider is a permanent personal mailbox, and most of your real users have one. A privacy alias forwards to a person's real inbox and hides the address; the person reads your mail and can reply, they just do not want to share their main address. Treating aliases as disposable turns away privacy-minded customers, which is why a yes/no disposable flag is not enough.
What to do with each category
Block disposable and testing. Allow free. Allow alias by default, or require extra verification if your product hands out something valuable at signup. For unknown, allow the signup but hold free credits until the email is confirmed: unknown means there is not enough evidence either way, not that the domain is safe. For domains that cannot receive mail, ask the person to check the address.
In code
The disban package for Node.js and Python wraps this policy as signupDecision / signup_decision, returning block, fix or allow.
// npm install disban
import { check } from "disban";
const r = await check("someone@simplelogin.com");
// r.category === "alias": a real person behind a relay
# pip install disban
from disban import check
check("someone@outlook.com")["category"] # "free"How the categories are decided
Disban first matches the domain against curated catalogs of free providers, relay services and testing tools, then its disposable inventory, then the mail servers the domain uses and the operators behind them, and finally a live mail-routing check. Every answer includes the reason and the evidence that matched, so a decision can be explained to the person it affects. Free API keys add 2,000 checks a month and batch requests of up to 50.
Source for provider behavior: Disban methodology. Product-policy guidance is Disban's interpretation.