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.

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": {}
}

{
  "details": {
    "sepa": {
      "sddCore": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sddB2b": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sct": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sctInst": {
        "status": "confirmed",
        "reason": "matched"
      }
    }
  }
}

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.

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.
• get_usage_info – Muestra el uso de la API sin consumir una solicitud de validación.

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.