BIC-Validierung

GET

bic

BIC-Validierung

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/bic/",
  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/bic/"

	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/bic/")

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

{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

Erste Schritte

Basis-URL

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

Validierungs-Endpunkt

Der bic-Endpunkt benötigt Ihren API-Schlüssel und einen BIC-Parameter zur umfassenden Validierung von Business Identifier Codes.

https://bankvalidation.cleariflow.com/v1/bic/
? api_key = YOUR_UNIQUE_API_KEY
& bic = DEUTDEFF500

Diese erfolgreiche Anfrage validiert einen deutschen BIC und liefert detaillierte Informationen:

{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

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

Der zu validierende Business Identifier Code. Leerzeichen sind erlaubt und werden bei der Verarbeitung automatisch entfernt. Der BIC sollte dem ISO-9362-Standardformat entsprechen.

Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen JSON-Format zurückgegeben.

String

Der normalisierte BIC ohne Leerzeichen, in Großbuchstaben.

Boolean

Gesamtergebnis der Validierung — ob der BIC allen Validierungsregeln entspricht.

String

Der zweistellige ISO-Ländercode (z. B. DE für Deutschland, US für Vereinigte Staaten).

String

Der vollständige Name des Landes, dem der BIC zugeordnet ist.

String

Der 4-stellige Bankidentifikationscode (z. B. DEUT für Deutsche Bank).

String

The name of the bank (currently shows “Bank information not available”).

String

Der 2-stellige Standortcode für Stadt oder Region (z. B. FF für Frankfurt).

String

Der 3-stellige Filialcode (optional, kann bei 8-stelligen BICs leer sein).

Object

Zusätzliche Detailinformationen zu BIC-Typ und Status.

String

Der Identifikatortyp (typischerweise „BIC”).

Boolean

Ob der BIC derzeit aktiv und in Verwendung ist.

String

Der Typ des Finanzinstituts (z. B. „Bank”, „Credit Union”).

Beispiele

Gültiger deutscher BIC (8 Zeichen)

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF

Antwort:

{
  "bic": "DEUTDEFF",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

Gültiger deutscher BIC (11 Zeichen mit Filiale)

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=DEUTDEFF500

Antwort:

{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "FF",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

Gültiger US-BIC

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=CHASUS33

Antwort:

{
  "bic": "CHASUS33",
  "is_valid": true,
  "country_code": "US",
  "country_name": "United States",
  "bank_code": "CHAS",
  "bank_name": "Bank information not available",
  "location_code": "33",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

Gültiger UK-BIC

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=NWBKGB2L

Antwort:

{
  "bic": "NWBKGB2L",
  "is_valid": true,
  "country_code": "GB",
  "country_name": "United Kingdom",
  "bank_code": "NWBK",
  "bank_name": "Bank information not available",
  "location_code": "2L",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

Ungültiger BIC

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY&bic=INVALID

Antwort:

{
  "bic": "INVALID",
  "is_valid": false,
  "country_code": "",
  "country_name": "",
  "bank_code": "",
  "bank_name": "Bank information not available",
  "location_code": "",
  "branch_code": "",
  "details": {
    "type": "BIC",
    "active": true
  }
}

Fehlerbehandlung

Fehlender BIC-Parameter

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?api_key=YOUR_API_KEY

Antwort:

{
  "error": {
    "message": "Missing bic",
    "code": "missing_bic"
  }
}

Missing API key

Anfrage:

GET https://bankvalidation.cleariflow.com/v1/bic/?bic=DEUTDEFF500

Antwort:

{
  "error": {
    "message": "API key is required",
    "code": "missing_api_key"
  }
}

BIC-Struktur

Der BIC besteht aus mehreren Komponenten:

Bankcode (4 Zeichen): Eindeutiger Identifikator des Finanzinstituts
Ländercode (2 Zeichen): ISO-3166-1-alpha-2-Ländercode
Standortcode (2 Zeichen): Kennung für Stadt oder Region
Filialcode (3 Zeichen): Optionale Filialkennung (XXX für Hauptstelle)

Formatbeispiele

8-stelliger BIC: DEUTDEFF (Deutsche Bank, Deutschland, Frankfurt)
11-stelliger BIC: DEUTDEFF500 (Deutsche Bank, Deutschland, Frankfurt, Filiale 500)

Häufige Standortcodes

FF: Frankfurt, Deutschland
33: New York, Vereinigte Staaten
2L: London, Vereinigtes Königreich
PP: Paris, Frankreich
MM: Mailand, Italien

Validation Rules

Die API führt umfassende Validierung durch, einschließlich:

Längenvalidierung: Prüft, ob der BIC 8 oder 11 Zeichen lang ist
Formatvalidierung: Prüft, ob der BIC dem ISO-9362-Standard entspricht
Zeichenvalidierung: Stellt sicher, dass nur alphanumerische Zeichen verwendet werden
Ländercode-Validierung: Validiert das Ländercode-Format
Bankcode-Validierung: Prüft das Format des Bankidentifikators

BIC-Formatanforderungen

Bankcode: 4 alphanumerische Zeichen
Ländercode: 2 alphabetische Zeichen (ISO 3166-1)
Standortcode: 2 alphanumerische Zeichen
Filialcode: 3 alphanumerische Zeichen (optional)

BIC vs. SWIFT

BIC (Business Identifier Code) und SWIFT werden oft synonym verwendet:

BIC: Offizieller Name nach ISO 9362
SWIFT: Das Messaging-Netzwerk, das den Code populär gemacht hat
SWIFT Code: Alternativbezeichnung für BIC

Alle BICs können für SWIFT-Messaging verwendet werden, aber nicht alle SWIFT-Codes sind gültige BICs.

Supported Countries

Die API unterstützt BIC-Validierung für über 50 Länder, darunter:

Europa: Deutschland, Frankreich, Italien, Spanien, Niederlande, Belgien, Österreich, Schweiz, UK, Polen
Amerika: Vereinigte Staaten, Kanada, Brasilien, Mexiko
Asien: Japan, Singapur, Hongkong, Australien
Afrika: Südafrika, Ägypten, Nigeria

For a complete list of supported countries, see the Supported Countries page.

Anwendungsfälle

BIC-Validierung ist wesentlich für:

Internationale Überweisungen: Sicherstellung korrekter Routing-Informationen
SEPA-Zahlungen: Anforderungen des europäischen Zahlungssystems
Bankanwendungen: Validierung von Kundenkonten
Finanz-Compliance: Anforderungen an regulatorische Meldungen
Zahlungsabwicklung: E-Commerce- und Fintech-Anwendungen

BIC-Validierung

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

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bankvalidation.cleariflow.com/v1/bic/",
  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/bic/"

	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/bic/")

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

{
  "bic": "DEUTDEFF500",
  "is_valid": true,
  "country_code": "DE",
  "country_name": "Germany",
  "bank_code": "DEUT",
  "bank_name": "Bank information not available",
  "location_code": "F",
  "branch_code": "500",
  "details": {
    "type": "BIC",
    "active": true,
    "institution_type": "Bank"
  }
}

Validierung

Abfrage

Erstellung

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Anfrageparameter

Antwortparameter

Beispiele

Gültiger deutscher BIC (8 Zeichen)

Gültiger deutscher BIC (11 Zeichen mit Filiale)

Gültiger US-BIC

Gültiger UK-BIC

Ungültiger BIC

Fehlerbehandlung

Fehlender BIC-Parameter

Missing API key

BIC-Struktur

Formatbeispiele

Häufige Standortcodes

Validation Rules

BIC-Formatanforderungen

BIC vs. SWIFT

Supported Countries

Anwendungsfälle

​Erste Schritte

​Basis-URL

​Validierungs-Endpunkt

​Anfrageparameter

​Antwortparameter

​Beispiele

​Gültiger deutscher BIC (8 Zeichen)

​Gültiger deutscher BIC (11 Zeichen mit Filiale)

​Gültiger US-BIC

​Gültiger UK-BIC

​Ungültiger BIC

​Fehlerbehandlung

​Fehlender BIC-Parameter

​Missing API key

​BIC-Struktur

​Formatbeispiele

​Häufige Standortcodes

​Validation Rules

​BIC-Formatanforderungen

​BIC vs. SWIFT

​Supported Countries

​Anwendungsfälle

Erste Schritte

Basis-URL

Validierungs-Endpunkt

Anfrageparameter

Antwortparameter

Beispiele

Gültiger deutscher BIC (8 Zeichen)

Gültiger deutscher BIC (11 Zeichen mit Filiale)

Gültiger US-BIC

Gültiger UK-BIC

Ungültiger BIC

Fehlerbehandlung

Fehlender BIC-Parameter

Missing API key

BIC-Struktur

Formatbeispiele

Häufige Standortcodes

Validation Rules

BIC-Formatanforderungen

BIC vs. SWIFT

Supported Countries

Anwendungsfälle