Documentación de la API

La API de IBAN-Test es la interfaz REST actual para validar IBAN, BIC y cuentas bancarias, así como para generar IBAN. Utiliza un token de API de tu panel de control y contabiliza las solicitudes funcionales en la cuota de tu plan.

Documentación interactiva para desarrolladores

La referencia técnica completa con parámetros, esquemas de respuesta y funciones de prueba está disponible en la vista OpenAPI.

Abrir la documentación OpenAPI

Autenticación

Utiliza el token de la vista general de la API directamente como token Bearer en la cabecera HTTP:

Authorization: Bearer TU_TOKEN_DE_API

Encontrarás el token después de iniciar sesión en el panel de control, en Vista general de la API.

URL base

https://www.iban-test.eu/api

Endpoints

GET /v2/iban/validate?iban=... – validar un IBAN
GET /v2/iban/validate/{iban} – validar alternativamente un IBAN como parámetro de ruta
POST /v2/iban/validate – validar un IBAN mediante el cuerpo de la solicitud
GET /v2/bic/validate/{bic} – validar un BIC
GET /v2/bank-account/validate?bankcode=...&accountnumber=... – validar una cuenta bancaria
GET /v2/iban/generate?countrycode=...&bankcode=...&accountnumber=... – generar un IBAN

Ejemplos

Validar un IBAN

curl -H "Authorization: Bearer TU_TOKEN_DE_API" \
  "https://www.iban-test.eu/api/v2/iban/validate?iban=DE89%203704%200044%200532%200130%2000"

Se permiten espacios en los IBAN y se eliminan automáticamente antes de la validación.

Validar un BIC

curl -H "Authorization: Bearer TU_TOKEN_DE_API" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Validar una cuenta bancaria

curl -H "Authorization: Bearer TU_TOKEN_DE_API" \
  "https://www.iban-test.eu/api/v2/bank-account/validate?bankcode=37040044&accountnumber=532013000"

Generar un IBAN

curl -H "Authorization: Bearer TU_TOKEN_DE_API" \
  "https://www.iban-test.eu/api/v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000"

Formato de respuesta

Todos los endpoints devuelven JSON. Los resultados de validación se incluyen en el cuerpo de la respuesta mediante error, code, message y, opcionalmente, details.

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

MCP para clientes de IA

Además de la API REST, IBAN-Test ofrece acceso mediante MCP. MCP significa Model Context Protocol y está diseñado para clientes de IA que pueden invocar herramientas de forma estructurada.

Endpoint MCP

Conecta tu cliente compatible con MCP al siguiente endpoint y utiliza tu token de API como token Bearer.

https://www.iban-test.eu/mcp

Authorization: Bearer TU_TOKEN_DE_API

Herramientas MCP disponibles

validate_iban – valida un único IBAN.
validate_iban_batch – valida varios IBAN en una llamada; cada IBAN cuenta como una solicitud de API.
generate_test_iban – genera un IBAN a partir del código de país, código bancario y número de cuenta.
ibantest_bank_account_validate – valida un código bancario alemán y un número de cuenta.
ibantest_bic_validate – valida un BIC y devuelve los datos bancarios disponibles.

Las herramientas MCP funcionales consumen la cuota de la API de IBAN-Test igual que las solicitudes REST.

Notas

La API REST y MCP utilizan tokens Bearer.
La API anterior basada en un código de autenticación ya no se incluye en esta documentación.
La documentación interactiva en /api/docs/IbanTest/html es la referencia técnica para parámetros y esquemas de respuesta.