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

Disposable Email Domain List API - Free Download

Returns a sorted array of all known disposable email domains in the database (700+). Optionally filter by a search substring to find specific providers. Use this to download the list for client-side validation or to audit your user database for disposable signups.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/disposable-email/list \
  -H "Content-Type: application/json" \
  -d '{"search":"guerrilla"}'

When to use this API

Download the list for client-side email validation

Fetch the full domain list once and cache it in your application. Check email domains locally without an API call per validation. Refresh the list weekly to catch new disposable services.

Audit your user database for disposable signups

Pull the list and run it against your users table. Identify accounts registered with throwaway emails. Flag them for review or re-verification campaigns.

Build a custom disposable email filter

Use the search parameter to find domains matching a pattern (e.g., all guerrillamail variants). Combine with your own blocklist for comprehensive coverage.

Frequently asked questions

How many domains are in the list?

The list contains 700+ domains and is updated periodically as new disposable email services appear.

Is the list sorted?

Yes. Domains are returned in alphabetical order.

How is this different from /v1/disposable-email/check?

The /check endpoint validates a single email address and tells you if it is disposable. The /list endpoint returns the full domain database so you can do local lookups without per-email API calls.

Does the search parameter support regex?

No. The search parameter does a simple case-insensitive substring match. Pass "mail" to find all domains containing "mail".

Can I use this list in my open-source project?

The list is provided via the API for use in your applications. There are no licensing restrictions on how you use the domain names returned by this endpoint.

Get your API key

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