POST AI agent ready /v1/disposable-email/check

Disposable Email Check API - Detect Throwaway Addresses

Validates an email address syntactically, extracts the domain, and reports three flags: is_disposable (matches a curated list of 700+ throwaway providers plus suspicious-name heuristics), is_free (matches common consumer providers like gmail.com, outlook.com), and provider (human-readable label when a match is found).

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/disposable-email/check \
  -H "Content-Type: application/json" \
  -d '{"email":"user@mailinator.com"}'

When to use this API

Block throwaway signups at the registration form

Call this endpoint when a user submits an email on your signup form. If is_disposable is true, reject the submission and ask for a real address. Stops burner accounts from inflating your free-tier usage.

Gate free-trial access to business email

Require is_free to be false before starting a free trial. This filters out personal gmail.com or hotmail.com addresses and keeps the trial queue focused on business prospects.

Audit your user database for low-quality accounts

Run every email in your users table through /check. Cross-reference is_disposable with signup date and feature usage to spot cohorts of suspicious accounts for review or re-verification.

Frequently asked questions

How is is_disposable determined?

Two checks: an exact match against a curated list of 700+ known disposable domains (mailinator, guerrillamail, 10minutemail, yopmail, tempmail, and more), plus a pattern scan that flags names containing "temp", "trash", "throwaway", "spam", "junk", or "burner".

What counts as is_free?

A match against 150+ well-known consumer email providers including gmail.com, outlook.com, yahoo.com, icloud.com, protonmail.com, and regional providers like yandex.ru, qq.com, and mail.ru.

Can a domain be both disposable and free?

No. The two lists are exclusive. A domain resolves to at most one of is_disposable or is_free. Corporate domains return false for both.

Does the endpoint verify the mailbox exists?

No. This endpoint only classifies the domain. To verify MX records resolve and the mailbox accepts mail, use /v1/email-mx/verify or /v1/email/validate.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.