> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /temporary-email

> Detect disposable and temporary email addresses before they enter your system. Returns a simple is_disposable boolean for any email domain.

## 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**

```json theme={null}
{
  "email": "user@tempmail.com",
  "domain": "tempmail.com",
  "is_disposable": true
}
```

### 401 Unauthorized

Missing or invalid API key.

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

Monthly quota exceeded.

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

Invalid email format.

```json theme={null}
{
  "detail": [
    {
      "loc": ["query", "email"],
      "msg": "value is not a valid email address",
      "type": "value_error.email"
    }
  ]
}
```

### 429 Too Many Requests

Rate limit exceeded.

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## cURL example

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