IBAN-Validierung

GET

iban

IBAN-Validierung

curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/iban/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bankvalidation.cleariflow.com/v1/iban/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bankvalidation.cleariflow.com/v1/iban/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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

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.

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.

String

Die normalisierte IBAN ohne Leerzeichen, in Großbuchstaben.

Boolean

Gesamtergebnis der Validierung — ob die IBAN allen Validierungsregeln entspricht.

String

Der zweistellige ISO-Ländercode (z. B. DE für Deutschland, FR für Frankreich).

String

Der vollständige Name des Landes, dem die IBAN zugeordnet ist.

String

Der aus der IBAN extrahierte Bankidentifikationscode gemäß dem länderspezifischen Format.

String

Der Kontonummernteil der IBAN ohne Ländercode, Prüfziffern und Bankcode.

Integer

Die tatsächliche Länge der übermittelten IBAN.

Integer

Die erwartete Länge für IBANs des jeweiligen Landes gemäß ISO 13616.

Boolean

Ob die IBAN-Prüfziffernvalidierung mit dem MOD-97-Algorithmus bestanden wurde.

Boolean

Ob das IBAN-Format der erwarteten Struktur des Landes entspricht.

Object

Zusätzliche Detailinformationen zur IBAN-Struktur und Formatierung.

String

Visuelle Darstellung der IBAN-Struktur mit Platzhaltern B (Bank), S (Sort), C (Customer) und K (Key).

String

Ein korrekt formatiertes IBAN-Beispiel mit Leerzeichen zur besseren Lesbarkeit.

String

Der Name der Bank (derzeit „Bank information not available”).

String

Der BIC-Code der Bank (derzeit „BIC not available”).

String

Der Kontotyp (typischerweise „Bank Account”).

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:

Ländercode (2 Zeichen): ISO-3166-1-alpha-2-Ländercode
Prüfziffern (2 Zeichen): MOD-97-Algorithmus-Validierung
Bankidentifikator: Länderspezifischer Bankcode
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:

Formatvalidierung: Prüft, ob die IBAN der erwarteten Struktur des Landes entspricht
Längenvalidierung: Prüft, ob die IBAN-Länge dem Landesstandard entspricht
Prüfziffernvalidierung: Führt MOD-97-Algorithmus-Validierung durch
Ländercode-Validierung: Stellt sicher, dass der Ländercode unterstützt wird
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.

IBAN-Validierung

curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/iban/

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/iban/",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bankvalidation.cleariflow.com/v1/iban/"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bankvalidation.cleariflow.com/v1/iban/")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

Validierung

Abfrage

Erstellung

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Anfrageparameter

Antwortparameter

Beispiele

Gültige deutsche IBAN

Gültige französische IBAN

Ungültige IBAN

Fehlerbehandlung

Fehlender IBAN-Parameter

Fehlender API-Schlüssel

IBAN-Struktur

Länderspezifische Formate

Validierungsregeln

Unterstützte Länder

​Erste Schritte

​Basis-URL

​Validierungs-Endpunkt

​Anfrageparameter

​Antwortparameter

​Beispiele

​Gültige deutsche IBAN

​Gültige französische IBAN

​Ungültige IBAN

​Fehlerbehandlung

​Fehlender IBAN-Parameter

​Fehlender API-Schlüssel

​IBAN-Struktur

​Länderspezifische Formate

​Validierungsregeln

​Unterstützte Länder

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Anfrageparameter

Antwortparameter

Beispiele

Gültige deutsche IBAN

Gültige französische IBAN

Ungültige IBAN

Fehlerbehandlung

Fehlender IBAN-Parameter

Fehlender API-Schlüssel

IBAN-Struktur

Länderspezifische Formate

Validierungsregeln

Unterstützte Länder