GET /temporary-email

Endpoint

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

Authentication

Header	Required	Value
`X-API-Key`	Yes	Your 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

Parameter	Type	Required	Description
`email`	string	Yes	The email address to check

Response

200 OK

Field	Type	Description
`email`	string	The email that was checked
`domain`	string	Extracted domain
`is_disposable`	boolean	`true` 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"

Introduction

API Reference

GET /temporary-email

Endpoint

Authentication

Overview

Use cases

Details

Query parameters

Response

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

cURL example

​Endpoint

​Authentication

​Overview

​Use cases

​Details

​Query parameters

​Response

​200 OK

​401 Unauthorized

​402 Payment Required

​422 Unprocessable Entity

​429 Too Many Requests

​cURL example

Endpoint

Authentication

Overview

Use cases

Details

Query parameters

Response

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

cURL example