API Documentation

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

Authentication

Use the API token from your API overview directly as a Bearer token in the HTTP header:

Authorization: Bearer YOUR_API_TOKEN

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

Base URL

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

Endpoints

• GET /v2/iban/validate?iban=... – validate an IBAN
• GET /v2/iban/validate/{iban} – alternatively validate an IBAN as a path parameter
• POST /v2/iban/validate – validate an IBAN using the request body
• 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_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate?iban=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_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Validate a bank account

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

Generate an IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/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.

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

Authorization: Bearer YOUR_API_TOKEN

Available MCP tools

• validate_iban – validates a single IBAN.
• validate_iban_batch – validates multiple IBANs in one call; each IBAN counts as one API request.
• generate_test_iban – 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 available bank details.

The functional MCP tools count against your IBAN-Test API quota just like REST requests.

Notes

• The REST API and MCP use Bearer tokens.
• The previous API using an 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.