Skip to main content

​
Endpoint

GET https://api.bunny.build/api/v1/temporary-email?email={email}

​
Authentication

HeaderRequiredValue
X-API-KeyYesYour API key (bun_...)

​
Overview

Detect disposable and temporary email addresses before they enter your system. Bunny maintains a continuously updated list of throwaway email providers and returns a simple is_disposable: true/false boolean for any email domain you check.

​
Use cases

  • Block fake signups and trial abuse
  • Enforce real-email policies on registration forms
  • Reduce bounce rates by filtering junk addresses
  • Protect mailing lists from disposable addresses

​
Details

Detection is based on the domain, not the local part. Subdomains of known disposable providers are also flagged. The check is case-insensitive.

​
Query parameters

ParameterTypeRequiredDescription
emailstringYesThe email address to check

​
Response

​
200 OK

FieldTypeDescription
emailstringThe email that was checked
domainstringExtracted domain
is_disposablebooleantrue if the domain is disposable/temporary
Example 
{
  "email": "user@tempmail.com",
  "domain": "tempmail.com",
  "is_disposable": true
}

​
401 Unauthorized

Missing or invalid API key. 
{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

Monthly quota exceeded. 
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

Invalid email format. 
{
  "detail": [
    {
      "loc": ["query", "email"],
      "msg": "value is not a valid email address",
      "type": "value_error.email"
    }
  ]
}

​
429 Too Many Requests

Rate limit exceeded. 
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
cURL example

curl "https://api.bunny.build/api/v1/temporary-email?email=user@tempmail.com" \
  -H "X-API-Key: bun_your_api_key"