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

# Einführung

> Die Cleariflow Bankvalidierungs-API bietet umfassende Validierung von International Bank Account Numbers (IBAN) und Business Identifier Codes (BIC) über eine moderne RESTful JSON-Schnittstelle — mit Unterstützung für über 50 Länder.

## Erste Schritte

<Card title="IBAN-Validierung" icon="credit-card" href="bank-validation/iban">
  Der `iban`-Endpunkt validiert International Bank Account Numbers mit umfassender länderspezifischer Prüfung, Formatkontrolle und detaillierten Strukturinformationen für Finanzanwendungen.
</Card>

<Card title="BIC-Validierung" icon="building" href="bank-validation/bic">
  Der `bic`-Endpunkt validiert Business Identifier Codes und liefert detaillierte Aufschlüsselungen von Bankcodes, Länderinformationen und Institutstypen für internationale Bankgeschäfte.
</Card>

<Card title="Unterstützte Länder" icon="globe" href="bank-validation/countries">
  Umfassende Liste der unterstützten Länder für IBAN- und BIC-Validierung, einschließlich Ländercodes, Währungsinformationen und spezifischer Formatierungsanforderungen.
</Card>

### REST-Architektur

Die Bankvalidierungs-API folgt REST-Prinzipien mit vorhersehbaren, ressourcenorientierten URLs und standardmäßigen HTTP-Statuscodes für nahtlose Integration und Fehlerbehandlung.

### HTTPS-Sicherheit

Alle API-Kommunikation wird mit TLS 1.2 oder höher verschlüsselt, um Datenintegrität und Datenschutz zu gewährleisten.

### API-Versionierung

Die Bankvalidierungs-API bleibt durch Versionierung abwärtskompatibel und befindet sich derzeit in Version 1 mit geplanten zukünftigen Erweiterungen.

### Authentifizierung

Ihr API-Schlüssel ist die ausschließliche Berechtigung für den Zugriff auf die Bankvalidierungs-API. Jeder Cleariflow-Dienst erfordert einen eigenen Schlüssel für sicheren und isolierten Zugriff.

## Antwort- und Fehlercodes

Bei fehlgeschlagenen Anfragen liefert die API strukturierte JSON-Fehlerantworten mit spezifischen Codes und Beschreibungen zur effektiven Fehlerbehebung.

| Code | Typ                   | Beschreibung                                                                                                    |
| ---- | --------------------- | --------------------------------------------------------------------------------------------------------------- |
| 200  | OK                    | Alles funktionierte wie erwartet.                                                                               |
| 400  | Bad request           | Fehlerhafte Anfrage — fehlende oder ungültige Parameter.                                                        |
| 401  | Unauthorized          | Die Anfrage war nicht zulässig — in der Regel fehlt der API-Schlüssel oder er ist ungültig.                     |
| 422  | Quota reached         | Die Anfrage wurde abgebrochen, da nicht genügend API-Guthaben vorhanden ist (kostenlose Tarife).                |
| 429  | Too many requests     | Das Anfragenlimit pro Sekunde wurde erreicht. Bei kostenlosen Tarifen gilt ein Limit von 1 Anfrage pro Sekunde. |
| 500  | Internal server error | Die Anfrage konnte aufgrund eines Serverfehlers nicht abgeschlossen werden.                                     |
| 503  | Service unavailable   | Der Server war nicht verfügbar.                                                                                 |