Zum Inhalt springen
IBANforge

BIC/SWIFT-Suche

GET /v1/bic/:code sucht einen bereits bekannten BIC im Verzeichnis und liefert verfügbare Referenzdaten zum Institut. Wenn Sie von einer IBAN ausgehen, nutzen Sie IBAN zu BIC. Die Suche bestätigt weder ein Konto noch dessen Inhaber oder die Durchführbarkeit einer Zahlung.

Dokumentation geprüft am 4. November 2026. Der OpenAPI-Vertrag beschreibt die vollständige Antwort.

Erster Aufruf mit Ihrem Schlüssel

Bewahren Sie den über den Einstieg erhaltenen Schlüssel auf und setzen Sie IBANFORGE_API_KEY auf Ihrem Server. API-Schlüssel und x402 sind getrennte Zugangswege. Der REST-Test ohne Schlüssel gilt nur für die Prüfung einer einzelnen IBAN, nicht für diese Suche. Die Preise und Kontingente erläutern den jeweiligen Zugang.

curl --silent --show-error --fail-with-body --max-time 20 \
  'https://api.ibanforge.com/v1/bic/UBSWCHZH' \
  -H "X-API-Key: ${IBANFORGE_API_KEY:?API-Schlüssel erforderlich}"

code akzeptiert einen BIC mit 8 oder 11 Zeichen, unabhängig von Gross- und Kleinschreibung. Ein BIC8 wird als BIC11 mit der Endung XXX gesucht. Das garantiert keinen vorhandenen Eintrag für den Hauptsitz. Ersetzen Sie den Platzhalter :code, statt ihn wörtlich zu senden.

Das Ergebnis vor der Verwendung lesen

Eine formal gültige Suche liefert HTTP 200 auch bei found: false. Ein fehlender Verzeichniseintrag ist kein 404 bic_not_found und beweist nicht, dass der Code unzugeteilt ist.

FeldBedeutung
bic, bic8, bic11Normalisierter Code und seine beiden Formen.
valid_formatPrüfung der BIC-Struktur, getrennt vom Eintrag im Verzeichnis.
found, institutionEin Eintrag nennt das Institut; andernfalls found: false und institution: null.
country.code, country.nameDas Land ist ein Objekt; countryCode gehört nicht zu dieser Antwort.
city, branch_code, branch_infoVerfügbare Orts- und Filialangaben; fehlende Angaben können null sein.
lei, lei_statusVerfügbare Kennung und Status der juristischen Person, keine Bestätigung des Kontoinhabers.
source, source_nameVerwendeter Datenbestand und sein lesbarer Name.
source_as_ofInhaltsdatum einer eingefrorenen Kopie, falls vorhanden. Ein fehlendes Feld bedeutet nicht, dass die Daten aktuell sind.
listed_in_current_sourceSpur des BIC8 in einer in diesem Zyklus aktualisierten Quelle. null bleibt unbekannt und wird nicht zu false.
shared_bic8, noteZusätzliche Angaben, wenn kein eindeutiges Institut aufgelöst wurde.

Bei einem gemeinsamen BIC8 ohne XXX-Eintrag kann shared_bic8 die vorhandenen Einträge unter diesem Präfix beschreiben. Fragen Sie nach dem vollständigen BIC11 der Gegenpartei; wählen Sie keine beliebige Bank aus.

address kann null sein. Falls eine Adresse vorliegt, erhalten Sie Quelle und Datum; eine Bankadresse ersetzt nicht die Adresse des Begünstigten. Zusätzliche Blöcke wie postal_address, official_identity oder pra_authorisation behalten ihre Quellenhinweise. Siehe Datenquellen und Grenzen.

Der Block sanctions betrifft das durch den BIC8 bezeichnete Institut. Er kann auch bei found: false vorliegen. Lesen Sie screened, listed und gegebenenfalls unscreened_lists: Eine nicht konsultierte Liste ergibt keinen negativen Befund. Der Name des Begünstigten wird damit nicht geprüft.

Beispiele für den Server

Die Beispiele wählen einige Felder zum Prüfen der Antwort aus. Erhalten Sie die vollständige Antwort in Ihrer eigenen Verarbeitung gemäss Ihren Aufbewahrungsregeln. Kein Beispiel gibt eine Zahlung frei.

Python, Standardbibliothek

import http.client
import json
import os
 
key = os.environ["IBANFORGE_API_KEY"]
if not key.strip():
    raise ValueError("Leerer API-Schlüssel")
 
connection = http.client.HTTPSConnection("api.ibanforge.com", timeout=20)
try:
    connection.request("GET", "/v1/bic/UBSWCHZH", headers={"X-API-Key": key})
    response = connection.getresponse()
    if response.status != 200:
        raise RuntimeError(f"HTTP {response.status} : siehe API-Fehler")
    data = json.loads(response.read())
finally:
    connection.close()
 
print(json.dumps({
    "found": data["found"],
    "institution": data.get("institution"),
    "source_name": data.get("source_name"),
    "source_as_of": data.get("source_as_of"),
    "listed_in_current_source": data.get("listed_in_current_source"),
    "shared_bic8": data.get("shared_bic8"),
    "note": data.get("note"),
}, ensure_ascii=False))

Node.js 22, Datei .mjs

const key = process.env.IBANFORGE_API_KEY;
if (!key?.trim()) throw new Error("API-Schlüssel fehlt oder ist leer");
 
const response = await fetch("https://api.ibanforge.com/v1/bic/UBSWCHZH", {
  headers: { "X-API-Key": key },
  signal: AbortSignal.timeout(20_000),
  redirect: "error",
});
if (response.status !== 200) {
  throw new Error(`HTTP ${response.status} : siehe API-Fehler`);
}
const data = await response.json();
console.log(JSON.stringify({
  found: data.found,
  institution: data.institution ?? null,
  source_name: data.source_name ?? null,
  source_as_of: data.source_as_of ?? null,
  listed_in_current_source: data.listed_in_current_source ?? null,
  shared_bic8: data.shared_bic8 ?? null,
  note: data.note ?? null,
}));

Fehler und nächste Schritte

HTTPBehandlung
400error und message lesen: etwa ungültige Struktur oder wörtlicher Platzhalter. Keinen korrigierten BIC erfinden.
402Zugangsgrund lesen: ungültiger Schlüssel, verbrauchtes Kontingent oder erforderliche Zahlung. Denselben Schlüssel behalten; nicht automatisch bezahlen.
429Ein geliefertes Retry-After beachten und Wiederholungen begrenzen.
5xx oder ZeitüberschreitungKein verwertbares Ergebnis dieses Versuchs; begrenzte Wiederholung und Prüfung vorsehen.

Die Beispiele lehnen auch Weiterleitungen ab. Der Schlüssel gehört weder in URLs und Bildschirmfotos noch in ausgelieferten Browsercode. Enthält die Antwort attribution, sind Text und Link bei der Anzeige für Nutzer zu beachten.

API-Schlüssel · Im Browser testen · Lieferantendatei prüfen

Nutzen Sie die Prüfungen für Ihren Anwendungsfall

Wählen Sie den ersten Schritt für Ihre Software oder Ihre Lieferantendatei.

IBAN-Prüfungen in Ihre Software integrieren

Testen Sie eine Validierung, sehen Sie sich die Antwort an und verbinden Sie Ihre Anwendung über die API oder eine vorhandene Integration.

API-Ablauf ansehen

Eine Lieferantendatei prüfen

Laden Sie eine CSV- oder Excel-Datei hoch und sehen Sie die Ergebnisse kostenlos in der Vorschau. Bei Bedarf kaufen Sie die kommentierte Arbeitsmappe. Ohne Konto oder Abonnement.

Dateiprüfung kennenlernen

Die verfügbaren Bankinformationen hängen von Land und Quelle ab. Diese Prüfungen bestätigen weder den Kontoinhaber noch die erfolgreiche Ausführung einer Zahlung.