The Email check API (POST /email/check) returns whether an email uses a disposable or temporary domain. Below are common use cases and how to implement them.

​
Signup and registration

Use case: Block or flag signups that use disposable email addresses to reduce fake accounts and abuse.
  • When: On registration or “Create account” before creating the user.
  • Flow: Call the API with the submitted email; if is_disposable is true, show an error or require a different email.
  • Benefit: Fewer one-off accounts, less spam, better quality signups.

Example

After the user submits the registration form, call client.email.check(email) (or POST /email/check). If result.is_disposable is true, reject with a message like “Disposable email addresses are not allowed.”

​
Contact and lead forms

Use case: Ensure contact and lead forms collect real, reachable email addresses.
  • When: On form submit (contact us, request demo, newsletter, etc.).
  • Flow: Check the email with the API; optionally allow but tag leads that use disposable domains for follow-up or scoring.
  • Benefit: Better lead quality and fewer bounces.

​
Fraud and abuse prevention

Use case: Reduce fraud and abuse that relies on throwaway emails.
  • When: Before high-value actions (e.g. checkout, payout, password reset to a new email).
  • Flow: If the email is disposable, block the action or require additional verification.
  • Benefit: Lower fraud and chargebacks.

​
Policy enforcement

Use case: Enforce a policy that certain features or tiers are not available with disposable emails.
  • When: When the user tries to enable a feature, upgrade, or change email to a disposable one.
  • Flow: Call the API; if is_disposable is true, show a policy message and block the change.
  • Benefit: Clear, consistent rules and fewer support disputes.

​
Implementation tips

  • Validate format first: Use client-side validation (e.g. regex) before calling the API; use the API for disposable detection.
  • Cache when appropriate: For repeated checks of the same domain, you can cache the result for a short TTL to reduce calls.
  • Use the helper: All SDKs provide is_disposable(email) for a simple boolean check.

Email API reference

Request/response and SDK usage.

API Reference

POST /email/check details.