Pular para o conteúdo principal

​
Endpoint

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

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua 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âmetroTipoObrigatórioDescrição
emailstringSimO endereço de e-mail a verificar

​
Resposta

​
200 OK

CampoTipoDescrição
emailstringO e-mail verificado
domainstringDomínio extraído
is_disposablebooleantrue se o domínio é descartável/temporário
Exemplo 
{
  "email": "user@tempmail.com",
  "domain": "tempmail.com",
  "is_disposable": true
}

​
401 Unauthorized

Chave de API ausente ou inválida. 
{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

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

​
422 Unprocessable Entity

Formato de e-mail inválido. 
{
  "detail": [
    {
      "loc": ["query", "email"],
      "msg": "value is not a valid email address",
      "type": "value_error.email"
    }
  ]
}

​
429 Too Many Requests

Limite de taxa excedido. 
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

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