Identidade e verificação

API de validação de IBAN e dados bancários

Detecte erros nos dados de pagamento antes que uma transferência falhe. Envie um IBAN, um BIC e um número de roteamento dos EUA em qualquer combinação e receba o problema exato, o código do banco e o número da conta, a participação no SEPA e se o BIC corresponde ao país do IBAN.

Ver documentação Testar a ferramenta gratuita Explorar todas as APIs

Pontos finais Ativo

POST /v1/bank/validate

Exemplo de requisição

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"iban": "DE89 3704 0044 0532 0130 00", "bic": "COBADEFFXXX"}' \
  "https://domscan.net/v1/bank/validate"

Exemplo de resposta 200 OK

{
  "valid": true,
  "iban": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "iban_print": "DE89 3704 0044 0532 0130 00",
    "country_code": "DE",
    "bank_code": "37040044",
    "account_number": "0532013000",
    "sepa": true,
    "checks": { "length": "pass", "structure": "pass", "checksum": "pass" }
  },
  "bic": { "valid": true, "bic":
...

Exemplo de requisição POST /v1/bank/validate

Principais Recursos 4

Perguntas frequentes 4

Códigos de status HTTP 200 / 400 / 401 / 402 / 409 / 422 / 429

Categoria Identidade e verificação

Pontos finais 1

Principais Recursos 4

Perguntas frequentes 4

Usado por pessoas nestas empresas

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

O que esta API ajuda você a lançar

Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.

Fluxo de integração

Um caminho simples da primeira requisição ao uso repetível em produção.

Autentique uma vez

Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.

Consulte com exemplos

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Opere e monitore

Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.

Kit de desenvolvedor

Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.

Esquema OpenAPI

Gere clientes ou inspecione cada formato de requisição e resposta.

Coleção Postman

Importe requisições prontas para testes manuais e repasse ao time.

SDKs e CLI

Use pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.

Integração MCP

Exponha inteligência de domínios para agentes de IA e assistentes internos.

Mapa de parâmetros e resposta

Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.

Parâmetros da requisição

Parâmetro

ibanbicrouting_number

Campos da resposta

Exemplo de resposta

validibaniban.validiban.ibaniban.iban_printiban.country_codeiban.bank_codeiban.account_numberiban.sepaiban.checksiban.checks.lengthiban.checks.structure

Cobertura de status

Códigos de status HTTP

200400401402409422429

Pontos finais

POST /v1/bank/validate

Créditos: 1Autenticação: Autenticação necessária

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Principais Recursos

Todos os países com IBAN

País, comprimento, formato nacional da conta e dígitos verificadores ISO 7064 de todos os países do registro de IBAN, além de territórios que usam o formato de um país de origem.

Código do banco e número da conta

Um IBAN válido é dividido em código do banco, código da agência e número da conta, nos formatos eletrônico e impresso.

BIC e números de roteamento

Estrutura e país do BIC/SWIFT, códigos de teste e números de roteamento ABA dos EUA com o dígito verificador e o distrito do Federal Reserve.

Privado por princípio

A validação funciona offline. Os números de conta nunca são enviados a terceiros e não ficam guardados nos registros de requisições.

Exemplo de requisição

POST /v1/bank/validate bash

curl -X POST -H "X-API-Key: $DOMSCAN_API_KEY" -H "Content-Type: application/json" \
  -d '{"iban": "DE89 3704 0044 0532 0130 00", "bic": "COBADEFFXXX"}' \
  "https://domscan.net/v1/bank/validate"

Exemplo de resposta

200 OK json

{
  "valid": true,
  "iban": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "iban_print": "DE89 3704 0044 0532 0130 00",
    "country_code": "DE",
    "bank_code": "37040044",
    "account_number": "0532013000",
    "sepa": true,
    "checks": { "length": "pass", "structure": "pass", "checksum": "pass" }
  },
  "bic": { "valid": true, "bic": "COBADEFFXXX", "institution_code": "COBA", "country_code": "DE" },
  "bic_iban_country_relation": "same",
  "signals": []
}

Perguntas frequentes

Um IBAN válido prova que a conta existe?

Não. Ele prova que o IBAN está bem formado, o que detecta quase todos os erros de digitação. Só o banco do titular pode confirmar que a conta está aberta e de quem ela é.

O que acontece quando o BIC é de outro país?

O resultado traz um sinal, nunca um erro, porque alguns pagamentos usam legitimamente um BIC de outro país. Territórios como Guernsey, Jersey ou os departamentos franceses ultramarinos são reconhecidos.

Vocês devolvem o nome do banco?

Não. Não existe um diretório gratuito, completo e oficial de nomes de bancos, então a API devolve os códigos do banco e da agência contidos no IBAN.

Quantos créditos custa?

Um crédito por requisição, quer você envie um IBAN, um BIC, um número de roteamento ou os três.

Ferramentas e recursos relacionados

Códigos de status HTTP

Estes são os códigos de status HTTP que você deve tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados ausentes e falhas de origem.

OK 200

Pedido bem-sucedido

Pedido inválido 400

Parâmetros inválidos

Não autorizado 401

Chave de API ou sessão em falta ou inválida.

Pagamento necessário 402

Não tens créditos suficientes para executar este pedido.

HTTP 409 409

Estes são os códigos de status HTTP que você deve tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados ausentes e falhas de origem.

HTTP 422 422

Estes são os códigos de status HTTP que você deve tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados ausentes e falhas de origem.

Demasiados pedidos 429

Limite de taxa excedido

Validar dados bancários

Começar gratuitamente Ver documentação Testar a ferramenta gratuita