POST AI agent ready /v1/validate/iban

API do validador IBAN - verifique e analise números de contas bancárias

Envie uma string IBAN e verifique se ela passa na validação estrutural e de soma de verificação, junto com o código do país, código de identificação do banco e dígitos de verificação. Suporta IBANs de mais de 80 países. O IBAN é processado no servidor e nunca armazenado.

Endpoint

Code examples

curl -X POST https://api.botoi.com/v1/validate/iban \
  -H "Content-Type: application/json" \
  -d '{"iban":"DE89370400440532013000"}'

When to use this API

Valide os dados bancários antes de iniciar transferências SEPA

Verifique o IBAN no ponto de entrada no seu formulário de pagamento. Detectar IBANs inválidos antes de enviá-los ao seu banco evita falhas nas transferências, taxas de devolução e atrasos nos pagamentos a fornecedores ou funcionários.

Detectar automaticamente o país para faturamento internacional

Extraia o código do país de um IBAN validado para definir automaticamente a moeda correta, as regras fiscais e o roteamento de transferência bancária para faturas internacionais.

Limpe arquivos de pagamento em massa de fornecedores

Valide cada IBAN em um CSV de pagamento em lote antes de carregá-lo em seu portal bancário. Sinalize entradas inválidas para que sua equipe financeira possa corrigi-las antes da execução do lote.

Frequently asked questions

Quantos países a validação do IBAN suporta?

Mais de 80 países que adotaram o padrão IBAN, incluindo todos os estados membros da UE/EEE, Reino Unido, Suíça, Arábia Saudita e Brasil. A lista completa segue o registro SWIFT IBAN.

Esta API verifica se a conta bancária existe?

Não. Ele valida a estrutura do IBAN e a soma de verificação para confirmar se o número está formatado corretamente. Ele não entra em contato com nenhum banco nem confirma se a conta está aberta ou financiada.

O IBAN que envio fica armazenado em algum lugar?

Não. O IBAN é validado na memória e descartado imediatamente. Nada é registrado ou persistido.

Posso enviar um IBAN com espaços?

Sim. Os espaços são eliminados antes da validação. "DE89 3704 0044 0532 0130 00" e "DE89370400440532013000" funcionam.

O que uma validação com falha retorna?

A resposta inclui válido: falso junto com um campo de motivo explicando a falha, como "Dígitos de verificação inválidos" ou "Código de país desconhecido".

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.