Pular para o conteúdo principal

​
Endpoint

POST https://api.bunny.build/api/v1/iban-validator

​
Autenticação

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

​
Visão geral

Valide Números de Conta Bancária Internacional (IBANs) conforme a especificação oficial de formato para todos os países participantes. Retorna metadados estruturais incluindo país, dígitos verificadores e o Número de Conta Bancária Básico (BBAN), para que você possa detectar entradas inválidas antes de iniciar uma transferência.

​
Casos de uso

  • Pré-validar IBANs antes de submeter transferências bancárias
  • Extrair dados de país e roteamento bancário de IBANs informados pelo usuário
  • Bloquear entradas de IBAN inválidas em formulários de pagamento em tempo real
  • Verificações de conformidade para fluxos de pagamento internacionais

​
Detalhes

Valida estrutura e dígitos verificadores para todos os países participantes do IBAN. A validade estrutural não garante que a conta exista; confirma apenas que o número está corretamente formado.

​
Corpo da requisição

CampoTipoObrigatórioDescrição
ibanstringSimIBAN a validar (espaços são ignorados)

​
Exemplo

{
  "iban": "DE89370400440532013000"
}

​
Resposta

​
200 OK

CampoTipoDescrição
validbooleanSe o IBAN é estruturalmente válido
ibanstringIBAN normalizado (sem espaços)
countrystringCódigo de país ISO
check_digitsstringOs dois dígitos verificadores
bbanstringNúmero de Conta Bancária Básico
Exemplo 
{
  "valid": true,
  "iban": "DE89370400440532013000",
  "country": "DE",
  "check_digits": "89",
  "bban": "370400440532013000"
}

​
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": "Invalid IBAN format or check digit mismatch"
}

​
429 Too Many Requests

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

​
Exemplo cURL

curl -X POST https://api.bunny.build/api/v1/iban-validator \
  -H "X-API-Key: bun_sua_chave_api" \
  -H "Content-Type: application/json" \
  -d '{"iban": "DE89370400440532013000"}'