API-Dokumentation

Die IBAN-Test API ist die aktuelle REST-Schnittstelle für IBAN-Validierung, BIC-Validierung, Bankdatenprüfung und IBAN-Generierung. Die API nutzt einen API-Token aus Ihrem Dashboard und zählt fachliche Anfragen gegen Ihr aktuelles API-Kontingent.

Interaktive Entwicklerdokumentation

Die vollständige technische Referenz mit Parametern, Response-Schemas und Testfunktion steht in der OpenAPI-Ansicht bereit.

OpenAPI-Dokumentation öffnen

Authentifizierung

Der API-Token aus der API-Übersicht wird direkt als Bearer Token im HTTP-Header verwendet:

Authorization: Bearer IHR_API_TOKEN

Den Token finden Sie nach dem Login im Dashboard im Bereich API-Übersicht.

Basis-URL

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

Endpunkte

GET /v2/iban/validate?iban=... – IBAN validieren
GET /v2/iban/validate/{iban} – IBAN alternativ als Pfadparameter validieren
POST /v2/iban/validate – IBAN per Request-Body validieren
GET /v2/bic/validate/{bic} – BIC validieren
GET /v2/bank-account/validate?bankcode=...&accountnumber=... – Bankkonto validieren
GET /v2/iban/generate?countrycode=...&bankcode=...&accountnumber=... – IBAN generieren

Beispiele

IBAN validieren

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

Leerzeichen in IBANs sind erlaubt und werden vor der Validierung automatisch entfernt.

BIC validieren

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

Bankkonto validieren

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

IBAN generieren

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

Antwortformat

Alle Endpunkte liefern JSON zurück. Fachliche Validierungsergebnisse stehen im Body über error, code, message und optional details.

{
  "error": false,
  "code": 2100,
  "message": "IBAN ist gültig",
  "details": {}
}

MCP für KI-Clients

Zusätzlich zur REST API stellt IBAN-Test einen MCP-Zugang bereit. MCP steht für Model Context Protocol und ist für KI-Clients gedacht, die Werkzeuge strukturiert aufrufen können.

MCP-Endpunkt

Verbinden Sie Ihren MCP-fähigen Client mit dem folgenden Endpunkt und verwenden Sie Ihren API-Token als Bearer Token.

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

Authorization: Bearer IHR_API_TOKEN

Verfügbare MCP-Tools

validate_iban – validiert eine einzelne IBAN.
validate_iban_batch – validiert mehrere IBANs in einem Aufruf; jede IBAN zählt als eine API-Anfrage.
generate_test_iban – generiert eine IBAN aus Ländercode, Bankleitzahl und Kontonummer.
ibantest_bank_account_validate – validiert eine deutsche Bankleitzahl und Kontonummer.
ibantest_bic_validate – validiert eine BIC und liefert verfügbare Bankdaten.

Die fachlichen MCP-Tools zählen wie REST-Anfragen gegen Ihr IBAN-Test API-Kontingent.

Hinweise

REST API und MCP verwenden Bearer Token.
Die frühere API mit Authcode ist in dieser Dokumentation nicht mehr enthalten.
Die interaktive Entwicklerdokumentation unter /api/docs/IbanTest/html ist die technische Referenz für Parameter und Response-Schemas.