Skip to content

Quickstart

The fastest way to see Fender work is the disposable-email endpoint. It needs no authentication for light, rate-limited use.

Terminal window
curl "https://api.fender.ai/v1/disposable?email=jane@mailinator.com"

You can also check a bare domain:

Terminal window
curl "https://api.fender.ai/v1/disposable?domain=guerrillamail.com"
{
"input": "jane@mailinator.com",
"domain": "mailinator.com",
"disposable": true,
"matched": "mailinator.com",
"reason": "domain_on_blocklist"
}
FieldMeaning
disposabletrue if the domain is a known throwaway provider.
matchedThe exact domain that matched the blocklist (or null).
reasonMachine-readable explanation.

Check up to 100 emails/domains in one call:

Terminal window
curl -X POST "https://api.fender.ai/v1/disposable/batch" \
-H "Content-Type: application/json" \
-d '{"emails":["a@gmail.com","b@mailinator.com"],"domains":["sharklasers.com"]}'