Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/email-validation

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)
Content-TypeSimapplication/json

​
Visão geral

Valide um endereço de e-mail em múltiplas camadas: formato de sintaxe, existência de registro MX no DNS e detecção de endereços baseados em função. A resposta também inclui uma sugestão de correção para erros de digitação comuns em domínios, permitindo que você oriente os usuários a corrigir erros óbvios antes de enviar.

​
Casos de uso

  • Bloquear endereços inválidos no cadastro para reduzir taxas de rejeição
  • Limpar listas de leads e bases de newsletters antes de envios de campanha
  • Exigir e-mails entregáveis em formulários de entrada de CRM
  • Exibir sugestões de correção para usuários que digitam domínios comuns errados

​
Corpo da requisição

CampoTipoObrigatórioDescrição
emailstringSimO endereço de e-mail a ser validado

​
Exemplo

{
  "email": "user@gmail.com"
}

​
Resposta

​
200 OK

CampoTipoDescrição
emailstringO endereço de e-mail avaliado
validbooleantrue quando as verificações de formato e MX passam
checksobjectResultados individuais: format (boolean), mx (boolean), role (boolean, true se for endereço de função)
mx_recordsarrayLista de registros MX, cada um com priority (integer) e exchange (string)
suggestionstringE-mail corrigido se um erro de digitação comum foi detectado, caso contrário null
Exemplo 
{
  "email": "user@gmail.com",
  "valid": true,
  "checks": {
    "format": true,
    "mx": true,
    "role": false
  },
  "mx_records": [
    { "priority": 5, "exchange": "gmail-smtp-in.l.google.com" }
  ],
  "suggestion": null
}
Exemplo com sugestão de correção 
{
  "email": "user@gamil.com",
  "valid": false,
  "checks": {
    "format": true,
    "mx": false,
    "role": false
  },
  "mx_records": [],
  "suggestion": "user@gmail.com"
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

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

​
422 Unprocessable Entity

{
  "detail": "Field 'email' is required."
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/email-validation \
  -H "X-API-Key: bun_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@gmail.com"}'