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

> Detecte e-mails descartáveis e temporários antes que entrem no seu sistema. Retorna um simples booleano is_disposable para qualquer domínio de e-mail.

## Endpoint

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

## Autenticação

| Header      | Obrigatório | Valor                        |
| ----------- | ----------- | ---------------------------- |
| `X-API-Key` | Sim         | Sua chave de API (`bun_...`) |

## Visão geral

Detecte endereços de e-mail descartáveis e temporários antes que entrem no seu sistema. A Bunny mantém uma lista continuamente atualizada de provedores de e-mail descartáveis e retorna um booleano simples, `is_disposable: true/false`, para qualquer domínio de e-mail verificado.

## Casos de uso

* Bloquear cadastros falsos e abusos de trial
* Aplicar políticas de e-mail real em formulários de registro
* Reduzir a taxa de bounce filtrando endereços inválidos
* Proteger listas de e-mail de endereços descartáveis

## Detalhes

A detecção é baseada no domínio, não na parte local. Subdomínios de provedores descartáveis conhecidos também são sinalizados. A verificação é insensível a maiúsculas e minúsculas.

## Parâmetros de query

| Parâmetro | Tipo   | Obrigatório | Descrição                        |
| --------- | ------ | ----------- | -------------------------------- |
| `email`   | string | Sim         | O endereço de e-mail a verificar |

## Resposta

### 200 OK

| Campo           | Tipo    | Descrição                                    |
| --------------- | ------- | -------------------------------------------- |
| `email`         | string  | O e-mail verificado                          |
| `domain`        | string  | Domínio extraído                             |
| `is_disposable` | boolean | `true` se o domínio é descartável/temporário |

**Exemplo**

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

### 401 Unauthorized

Chave de API ausente ou inválida.

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

### 402 Payment Required

Cota mensal excedida.

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

### 422 Unprocessable Entity

Formato de e-mail inválido.

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

### 429 Too Many Requests

Limite de taxa excedido.

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

## Exemplo cURL

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