​
Endpoint

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

​
Authentication

HeaderRequiredValue
X-API-KeyYesYour API key (sec4_...)
Content-TypeYesapplication/json
AcceptRecommendedapplication/json

​
Request body

FieldTypeRequiredDescription
emailstringYesValid email address (one @, non-empty local and domain with at least one dot)

​
Example

{
  "email": "[email protected]"
}

​
Response

​
200 OK

FieldTypeDescription
emailstringThe email that was checked
domainstringExtracted domain
is_disposablebooleantrue if domain is disposable/temporary
Example 
{
  "email": "[email protected]",
  "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": ["body", "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 -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]"}'