Zum Hauptinhalt springen
GET
/
v1
/
iban
IBAN-Validierung
curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/
{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Erste Schritte

​
Basis-URL

https://bankvalidation.cleariflow.com/v1/iban/

​
Validierungs-Endpunkt

Der iban-Endpunkt benötigt Ihren API-Schlüssel und einen IBAN-Parameter zur umfassenden Validierung von International Bank Account Numbers. 
https://bankvalidation.cleariflow.com/v1/iban/
? api_key = YOUR_UNIQUE_API_KEY
& iban = DE89370400440532013000
Diese erfolgreiche Anfrage validiert eine deutsche IBAN und liefert detaillierte Informationen: 
{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Anfrageparameter

​
api_key
String
erforderlich
Ihr eindeutiger API-Schlüssel. Beachten Sie, dass jeder Nutzer für jede Cleariflow-API eigene API-Schlüssel hat — Ihr Bankvalidierungs-API-Schlüssel funktioniert z. B. nicht für die Wechselkurs-API.
​
iban
String
erforderlich
Die zu validierende International Bank Account Number. Leerzeichen sind erlaubt und werden bei der Verarbeitung automatisch entfernt. Die IBAN sollte dem ISO-13616-Standardformat entsprechen.

​
Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben.
​
iban
String
Die normalisierte IBAN ohne Leerzeichen, in Großbuchstaben.
​
is_valid
Boolean
Gesamtergebnis der Validierung — ob die IBAN allen Validierungsregeln entspricht.
​
country_code
String
Der zweistellige ISO-Ländercode (z. B. DE für Deutschland, FR für Frankreich).
​
country_name
String
Der vollständige Name des Landes, dem die IBAN zugeordnet ist.
​
bank_code
String
Der aus der IBAN extrahierte Bankidentifikationscode gemäß dem länderspezifischen Format.
​
account_number
String
Der Kontonummernteil der IBAN ohne Ländercode, Prüfziffern und Bankcode.
​
length
Integer
Die tatsächliche Länge der übermittelten IBAN.
​
expected_length
Integer
Die erwartete Länge für IBANs des jeweiligen Landes gemäß ISO 13616.
​
checksum_valid
Boolean
Ob die IBAN-Prüfziffernvalidierung mit dem MOD-97-Algorithmus bestanden wurde.
​
format_valid
Boolean
Ob das IBAN-Format der erwarteten Struktur des Landes entspricht.
​
details
Object
Zusätzliche Detailinformationen zur IBAN-Struktur und Formatierung.
​
details.structure
String
Visuelle Darstellung der IBAN-Struktur mit Platzhaltern B (Bank), S (Sort), C (Customer) und K (Key).
​
details.example
String
Ein korrekt formatiertes IBAN-Beispiel mit Leerzeichen zur besseren Lesbarkeit.
​
details.bank_name
String
Der Name der Bank (derzeit „Bank information not available”).
​
details.bank_bic
String
Der BIC-Code der Bank (derzeit „BIC not available”).
​
details.account_type
String
Der Kontotyp (typischerweise „Bank Account”).
​
details.currency
String
Der Währungscode des Landes (z. B. EUR für Eurozone-Länder, GBP für UK).

​
Beispiele

​
Gültige deutsche IBAN

Anfrage: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=DE89370400440532013000
Antwort: 
{
  "iban": "DE89370400440532013000",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "37040044",
  "account_number": "0532013000",
  "length": 22,
  "expected_length": 22,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BBBB BBBB BBBB BB",
    "example": "DE89 3704 0044 0532 0130 00",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Gültige französische IBAN

Anfrage: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=FR1420041010050500013M02606
Antwort: 
{
  "iban": "FR1420041010050500013M02606",
  "is_valid": true,
  "country_code": "FR",
  "country_name": "France",
  "bank_code": "2004101005",
  "account_number": "0500013M02606",
  "length": 27,
  "expected_length": 27,
  "checksum_valid": true,
  "format_valid": true,
  "details": {
    "structure": "BBBB BSSS SSCC CCCC CCCC CCC KK",
    "example": "FR14 2004 1010 0505 0001 3M02 606",
    "bank_name": "Bank information not available",
    "bank_bic": "BIC not available",
    "account_type": "Bank Account",
    "currency": "EUR"
  }
}

​
Ungültige IBAN

Anfrage: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY&iban=INVALID
Antwort: 
{
  "iban": "",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "account_number": "",
  "length": 7,
  "expected_length": 0,
  "checksum_valid": false,
  "format_valid": false,
  "details": {
    "structure": "",
    "example": ""
  }
}

​
Fehlerbehandlung

​
Fehlender IBAN-Parameter

Anfrage: 
GET https://bankvalidation.cleariflow.com/v1/iban/?api_key=YOUR_API_KEY
Antwort: 
{
  "error": {
    "message": "Missing iban",
    "code": "missing_iban"
  }
}

​
Fehlender API-Schlüssel

Anfrage: 
GET https://bankvalidation.cleariflow.com/v1/iban/?iban=DE89370400440532013000
Antwort: 
{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

​
IBAN-Struktur

Die IBAN besteht aus mehreren Komponenten:
  1. Ländercode (2 Zeichen): ISO-3166-1-alpha-2-Ländercode
  2. Prüfziffern (2 Zeichen): MOD-97-Algorithmus-Validierung
  3. Bankidentifikator: Länderspezifischer Bankcode
  4. Kontonummer: Kundenkontokennung

​
Länderspezifische Formate

Verschiedene Länder haben unterschiedliche IBAN-Strukturen:
  • Deutschland (DE): 22 Zeichen — BBBB BBBB BBBB BBBB BB
  • Frankreich (FR): 27 Zeichen — BBBB BSSS SSCC CCCC CCCC CCC KK
  • Italien (IT): 27 Zeichen — CAAA AABB BBSS CCCC CCCC CCX
  • Vereinigtes Königreich (GB): 22 Zeichen — BBBB SSSS SSCC CCCC CC
  • Spanien (ES): 24 Zeichen — BBBB SSSS DDCC CCCC CCCC CC
Dabei gilt:
  • B = Bankcode
  • S = Sort-Code
  • C = Kundenkontonummer
  • K = Schlüssel-/Prüfziffer
  • A = Kontotyp
  • D = Kontrollziffer

​
Validierungsregeln

Die API führt umfassende Validierung durch, einschließlich:
  1. Formatvalidierung: Prüft, ob die IBAN der erwarteten Struktur des Landes entspricht
  2. Längenvalidierung: Prüft, ob die IBAN-Länge dem Landesstandard entspricht
  3. Prüfziffernvalidierung: Führt MOD-97-Algorithmus-Validierung durch
  4. Ländercode-Validierung: Stellt sicher, dass der Ländercode unterstützt wird
  5. Zeichenvalidierung: Prüft auf gültige alphanumerische Zeichen

​
Unterstützte Länder

Die API unterstützt IBAN-Validierung für über 50 Länder, darunter:
  • Europa: Deutschland, Frankreich, Italien, Spanien, Niederlande, Belgien, Österreich, Schweiz, UK, Polen
  • Asien: VAE, Bahrain, Israel, Jordanien, Kasachstan, Kuwait
  • Amerika: Brasilien, Costa Rica, Dominikanische Republik, Guatemala
  • Afrika: Mauretanien, Mauritius, Tunesien
Eine vollständige Liste finden Sie auf der Seite Unterstützte Länder.