> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cleariflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BIC-Validierung

> Der `bic`-Endpunkt validiert Business Identifier Codes und liefert detaillierte Aufschlüsselungen von Bankcodes, Länderinformationen und Institutstypen für internationale Bankgeschäfte.

## 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:

<ResponseExample>
  ```json theme={"system"}
  {
    "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"
    }
  }
  ```
</ResponseExample>

### Anfrageparameter

<ParamField query="api_key" type="String" required>
  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.
</ParamField>

<ParamField query="bic" type="String" required>
  Der zu validierende Business Identifier Code. Leerzeichen sind erlaubt und werden bei der Verarbeitung automatisch entfernt. Der BIC sollte dem ISO-9362-Standardformat entsprechen.
</ParamField>

### Antwortparameter

Die API-Antwort wird in einem universellen und leichtgewichtigen [JSON-Format](https://www.json.org/json-en.html) zurückgegeben.

<ResponseField name="bic" type="String">
  Der normalisierte BIC ohne Leerzeichen, in Großbuchstaben.
</ResponseField>

<ResponseField name="is_valid" type="Boolean">
  Gesamtergebnis der Validierung — ob der BIC allen Validierungsregeln entspricht.
</ResponseField>

<ResponseField name="country_code" type="String">
  Der zweistellige ISO-Ländercode (z. B. DE für Deutschland, US für Vereinigte Staaten).
</ResponseField>

<ResponseField name="country_name" type="String">
  Der vollständige Name des Landes, dem der BIC zugeordnet ist.
</ResponseField>

<ResponseField name="bank_code" type="String">
  Der 4-stellige Bankidentifikationscode (z. B. DEUT für Deutsche Bank).
</ResponseField>

<ResponseField name="bank_name" type="String">
  The name of the bank (currently shows "Bank information not available").
</ResponseField>

<ResponseField name="location_code" type="String">
  Der 2-stellige Standortcode für Stadt oder Region (z. B. FF für Frankfurt).
</ResponseField>

<ResponseField name="branch_code" type="String">
  Der 3-stellige Filialcode (optional, kann bei 8-stelligen BICs leer sein).
</ResponseField>

<ResponseField name="details" type="Object">
  Zusätzliche Detailinformationen zu BIC-Typ und Status.
</ResponseField>

<ResponseField name="details.type" type="String">
  Der Identifikatortyp (typischerweise „BIC").
</ResponseField>

<ResponseField name="details.active" type="Boolean">
  Ob der BIC derzeit aktiv und in Verwendung ist.
</ResponseField>

<ResponseField name="details.institution_type" type="String">
  Der Typ des Finanzinstituts (z. B. „Bank", „Credit Union").
</ResponseField>

## Beispiele

### Gültiger deutscher BIC (8 Zeichen)

**Anfrage:**

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

**Antwort:**

```json theme={"system"}
{
  "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:**

```json theme={"system"}
{
  "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:**

```json theme={"system"}
{
  "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:**

```json theme={"system"}
{
  "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:**

```json theme={"system"}
{
  "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:**

```json theme={"system"}
{
  "error": {
    "message": "Missing bic",
    "code": "missing_bic"
  }
}
```

### Missing API key

**Anfrage:**

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

**Antwort:**

```json theme={"system"}
{
  "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](/bank-validation/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