API-Dokumentation

Die IBAN-Test API v2 ist die aktuelle REST-Schnittstelle für IBAN-Validierung, BIC-Validierung, Bankdatenprüfung und IBAN-Generierung. Die API nutzt einen API v2 Token aus Ihrem Dashboard und zählt alle 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

Senden Sie Ihren API v2 Token als Bearer Token im HTTP-Header:

Authorization: Bearer IHR_API_V2_TOKEN

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

Basis-URL

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

Endpunkte

  • GET /v2/iban/validate/{iban} - IBAN 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_V2_TOKEN" \
  "https://www.iban-test.de/api/IbanTest/v2/iban/validate/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_V2_TOKEN" \
  "https://www.iban-test.de/api/IbanTest/v2/bic/validate/COBADEFFXXX"

Bankkonto validieren

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

IBAN generieren

curl -H "Authorization: Bearer IHR_API_V2_TOKEN" \
  "https://www.iban-test.de/api/IbanTest/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 valide",
  "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 Endpoint und verwenden Sie Ihren API v2 Token als Bearer Token.

https://www.iban-test.de/mcp
Authorization: Bearer IHR_API_V2_TOKEN

Verfügbare MCP-Tools

  • ibantest_iban_validate - validiert eine IBAN und liefert Validierungsdetails.
  • ibantest_iban_generate - 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 Format- und Bankdatenhinweise.
  • ibantest_api_usage - zeigt die aktuelle API-Nutzung des authentifizierten Nutzers an.

Die fachlichen MCP-Tools zählen wie REST-Anfragen gegen Ihr IBAN-Test API-Kontingent. ibantest_api_usage zeigt nur die Nutzung an und erhöht den Zähler nicht.

Hinweise

  • Die v2 API verwendet ausschließlich API v2 Tokens.
  • Die alte v1 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.