The Email API checks whether an email address uses a disposable or temporary domain. Use it to block signups from throwaway addresses or to flag risky emails.

​
Endpoint

POST https://api.bunny.build/api/v1/email/check

Request body

Send a JSON body with one field: email (string, required). The email must be valid (one @, non-empty local part and domain with at least one dot).

​
Response (200)

FieldTypeDescription
emailstringThe email that was checked
domainstringExtracted domain
is_disposablebooleantrue if the domain is disposable
Example: 
{
  "email": "[email protected]",
  "domain": "tempmail.com",
  "is_disposable": true
}

​
Example

curl -X POST https://api.bunny.build/api/v1/email/check \
  -H "X-API-Key: sec4_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]"}'

​
SDK helpers

All SDKs provide:
  • check(email) — Returns the full result object
  • is_disposable(email) — Returns only a boolean

​
Errors

StatusMeaning
401Missing or invalid API key
422Invalid email format
429Rate limit exceeded
402Quota exceeded
See API Reference → POST /email/check for full request/response and error bodies.