Uma API de verificação de e-mail que simplesmente funciona

Autenticação

Envie sua chave de API como bearer token no cabeçalho Authorization em todas as solicitações. Mantenha as chaves no seu servidor. Nunca as coloque em código de navegador ou em apps móveis.

Authorization: Bearer YOUR_API_KEY

A URL base de todos os endpoints é https://bouncebell.com/api/v1.

Verificar um endereço

GET https://bouncebell.com/api/v1/verify

Exemplo

curl "https://bouncebell.com/api/v1/verify?email=rini.elizabeth%40acme-foods.example" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "email": "rini.elizabeth@acme-foods.example",
  "status": "valid",
  "reason": "mailbox_exists",
  "domain": "acme-foods.example",
  "mx_record": "mx1.acme-foods.example",
  "disposable": false,
  "role": false,
  "free_provider": false,
  "catch_all": false,
  "did_you_mean": null,
  "checked_at": "2026-10-30T09:30:12Z",
  "credits_used": 1
}

Campos do resultado

Status

Lotes

Envie até 100.000 endereços em uma única solicitação. O lote é processado em segundo plano; consulte o status ou informe uma callback_url e nós a chamaremos quando o lote terminar.

Criar um lote

POST https://bouncebell.com/api/v1/batches

curl -X POST "https://bouncebell.com/api/v1/batches" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "October import", "emails": ["a@example.com", "b@example.com"],
       "callback_url": "https://yourapp.example/hooks/bouncebell"}'

{ "id": "bat_8f2k1q3m9x7w4p", "status": "queued", "total": 2, "done": 0 }

Os créditos de cada endereço único são reservados quando o lote é criado, e os resultados desconhecidos são reembolsados quando ele termina. O callback recebe um POST com {"event": "batch.completed", "batch_id": "...", "status": "done", "counts": {...}}. As URLs de callback devem usar HTTPS.

Consultar o progresso

GET https://bouncebell.com/api/v1/batches/{id}

{ "id": "bat_8f2k1q3m9x7w4p", "status": "running", "total": 2, "done": 1 }

O status é queued, running ou done. Quando é done, a resposta também traz counts por status.

Baixar resultados

GET https://bouncebell.com/api/v1/batches/{id}/results

Retorna JSON por padrão. Adicione ?format=csv para receber um arquivo CSV. Cada linha tem os mesmos campos de uma verificação individual.

Créditos

GET https://bouncebell.com/api/v1/credits

{ "credits_remaining": 33420 }

Erros e limites

Os erros retornam um corpo JSON com um código error e uma message legível.

As verificações individuais são limitadas a 20 solicitações por segundo por chave. Fale com a gente se precisar de mais.