Disposable email
Detects whether an email address or domain belongs to a known disposable / temporary email provider (Mailinator, Guerrilla Mail, 10MinuteMail, etc.).
GET /v1/disposable
Section titled “GET /v1/disposable”| Query param | Type | Description |
|---|---|---|
email | string | Full email address. Provide this or domain. |
domain | string | Bare domain. Provide this or email. |
curl "https://api.fender.ai/v1/disposable?email=test@mailinator.com"{ "input": "test@mailinator.com", "domain": "mailinator.com", "disposable": true, "matched": "mailinator.com", "reason": "domain_on_blocklist"}Response fields
Section titled “Response fields”| Field | Type | Description |
|---|---|---|
disposable | boolean | Whether the domain is a known throwaway provider. |
domain | string | null | The normalized domain checked. |
matched | string | null | The blocklist entry that matched. |
reason | string | domain_on_blocklist, not_on_blocklist, invalid_email, … |
Subdomains are resolved to their parent (e.g. inbox.mailinator.com →
mailinator.com).
POST /v1/disposable/batch
Section titled “POST /v1/disposable/batch”Check up to 100 items in one request.
curl -X POST "https://api.fender.ai/v1/disposable/batch" \ -H "Content-Type: application/json" \ -d '{"emails":["a@gmail.com","b@mailinator.com"]}'Try it
Section titled “Try it”Anonymous requests are rate limited to 30/min. No key required.
Result will appear here…