API Documentation

The IBAN-Test API v2 is the current REST interface for IBAN validation, BIC validation, bank account validation and IBAN generation. The API uses an API v2 token from your dashboard and counts requests against your current API quota.

Interactive developer documentation

The complete technical reference with parameters, response schemas and test functionality is available in the OpenAPI view.

Open OpenAPI documentation

Authentication

Send your API v2 token as a Bearer token in the HTTP header:

Authorization: Bearer YOUR_API_V2_TOKEN

You can find the token after logging in to your dashboard under API overview.

Base URL

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

Endpoints

GET /v2/iban/validate/{iban} - validate an IBAN
GET /v2/bic/validate/{bic} - validate a BIC
GET /v2/bank-account/validate?bankcode=...&accountnumber=... - validate a bank account
GET /v2/iban/generate?countrycode=...&bankcode=...&accountnumber=... - generate an IBAN

Examples

Validate an IBAN

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

Spaces in IBANs are allowed and are removed automatically before validation.

Validate a BIC

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

Validate a bank account

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

Generate an IBAN

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

Response format

All endpoints return JSON. Validation results are provided in the response body via error, code, message and optional details.

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

MCP for AI clients

In addition to the REST API, IBAN-Test provides MCP access. MCP stands for Model Context Protocol and is designed for AI clients that can call tools in a structured way.

MCP endpoint

Connect your MCP-capable client to the following endpoint and use your API v2 token as the Bearer token.

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

Authorization: Bearer YOUR_API_V2_TOKEN

Available MCP tools

ibantest_iban_validate - validates an IBAN and returns validation details.
ibantest_iban_generate - generates an IBAN from country code, bank code and account number.
ibantest_bank_account_validate - validates a German bank code and account number.
ibantest_bic_validate - validates a BIC and returns format and bank data information.
ibantest_api_usage - shows the current API usage for the authenticated user.

The functional MCP tools count against your IBAN-Test API quota just like REST requests. ibantest_api_usage only displays usage and does not increase the counter.

Notes

The v2 API only uses API v2 tokens.
The old v1 API with auth code is no longer covered in this documentation.
The interactive developer documentation at /api/docs/IbanTest/html is the technical reference for parameters and response schemas.