Zum Hauptinhalt springen
GET
/
v1
/
bic
BIC-Validierung
curl --request GET \
  --url https://bankvalidation.cleariflow.com/v1/bic/
{
  "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

​
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.
​
bic
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.
​
bic
String
Der normalisierte BIC ohne Leerzeichen, in Großbuchstaben.
​
is_valid
Boolean
Gesamtergebnis der Validierung — ob der BIC allen Validierungsregeln entspricht.
​
country_code
String
Der zweistellige ISO-Ländercode (z. B. DE für Deutschland, US für Vereinigte Staaten).
​
country_name
String
Der vollständige Name des Landes, dem der BIC zugeordnet ist.
​
bank_code
String
Der 4-stellige Bankidentifikationscode (z. B. DEUT für Deutsche Bank).
​
bank_name
String
The name of the bank (currently shows “Bank information not available”).
​
location_code
String
Der 2-stellige Standortcode für Stadt oder Region (z. B. FF für Frankfurt).
​
branch_code
String
Der 3-stellige Filialcode (optional, kann bei 8-stelligen BICs leer sein).
​
details
Object
Zusätzliche Detailinformationen zu BIC-Typ und Status.
​
details.type
String
Der Identifikatortyp (typischerweise „BIC”).
​
details.active
Boolean
Ob der BIC derzeit aktiv und in Verwendung ist.
​
details.institution_type
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:
  1. Bankcode (4 Zeichen): Eindeutiger Identifikator des Finanzinstituts
  2. Ländercode (2 Zeichen): ISO-3166-1-alpha-2-Ländercode
  3. Standortcode (2 Zeichen): Kennung für Stadt oder Region
  4. 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:
  1. Längenvalidierung: Prüft, ob der BIC 8 oder 11 Zeichen lang ist
  2. Formatvalidierung: Prüft, ob der BIC dem ISO-9362-Standard entspricht
  3. Zeichenvalidierung: Stellt sicher, dass nur alphanumerische Zeichen verwendet werden
  4. Ländercode-Validierung: Validiert das Ländercode-Format
  5. 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:
  1. Internationale Überweisungen: Sicherstellung korrekter Routing-Informationen
  2. SEPA-Zahlungen: Anforderungen des europäischen Zahlungssystems
  3. Bankanwendungen: Validierung von Kundenkonten
  4. Finanz-Compliance: Anforderungen an regulatorische Meldungen
  5. Zahlungsabwicklung: E-Commerce- und Fintech-Anwendungen