IBAN validieren

Validieren Sie eine einzelne IBAN mit vollständiger Prüfsummenverifizierung, länderspezifischer BBAN-Strukturanalyse, automatischer BIC/Instituts-Abfrage, SEPA-Konformitätsdaten, Emittentenklassifizierung (Bank vs. E-Geld-Institut/Neobank) und Risikoindikatoren für Compliance-Agenten. Länge und Aufbau jedes Landes, mit dem offiziellen Beispiel und dem geprüften Register, stehen unter IBAN nach Land.

Endpunkt

POST https://api.ibanforge.com/v1/iban/validate

Kosten: $0.005 USDC pro Anfrage

Anfrage

Header

Body

{
  "iban": "CH10 0023 0000 0000 1234 5"
}

Antwort

Erfolg (200)

{
  "iban": "CH1000230000000012345",
  "valid": true,
  "country": {
    "code": "CH",
    "name": "Switzerland"
  },
  "check_digits": "10",
  "bban": {
    "bank_code": "00230",
    "account_number": "000000012345"
  },
  "bic": {
    "code": "UBSWCHZH80A",
    "bic8": "UBSWCHZH",
    "bank_name": "UBS Switzerland AG",
    "city": "Zürich",
    "basis": "national_register",
    "authoritative": true
  },
  "sepa": {
    "member": true,
    "schemes": ["SCT", "SDD"],
    "vop_required": false,
    "vop_participant": false
  },
  "issuer": {
    "type": "bank",
    "name": "UBS Switzerland AG",
    "classification": "default"
  },
  "bank_code_check": {
    "value": "00230",
    "status": "verified",
    "match": "register",
    "register": "SIX BankMaster (Swiss IID / BC-Nummer register)",
    "authoritative": true,
    "institution": {
      "name": "UBS Switzerland AG",
      "street": "Bahnhofstrasse 45",
      "post_code": "8098",
      "town": "Zürich",
      "country": "CH"
    },
    "as_of": "2026-08"
  },
  "risk_indicators": {
    "issuer_type": "bank",
    "country_risk": "standard",
    "test_bic": false,
    "sepa_reachable": true,
    "sepa_reachable_scope": "country",
    "vop_coverage": false
  },
  "clearing": {
    "iid": "00230",
    "name": "UBS Switzerland AG",
    "type": "bank",
    "town": "Zürich",
    "sic": true,
    "instant_payments_chf": true,
    "eurosic": true,
    "qr_iid": null
  },
  "formatted": "CH10 0023 0000 0000 1234 5",
  "cost_usdc": 0.005,
  "processing_ms": 1.23
}

Antwortfelder

Felder auf oberster Ebene:

country-Objekt:

bban-Objekt:

bic-Objekt (vorhanden, wenn ein passender BIC gefunden wurde):

sepa-Objekt:

issuer-Objekt (vorhanden, wenn BIC aufgelöst wurde):

vIBAN-Erkennung: Wenn issuer.type den Wert emi, digital_bank oder payment_institution hat, handelt es sich mit höherer Wahrscheinlichkeit um eine virtuelle IBAN (vIBAN). Dies ist nützlich für die AML/CFT-Compliance gemäß der EU-AMLR-Verordnung (Juli 2027).

bank_code_check-Objekt:

risk_indicators-Objekt:

Was „verified" bedeutet — und was nicht

bank_code_check.status: "verified" bedeutet: Der Bankcode löst in den konsultierten Referenzdaten zu einem Institut auf, das wir benennen können. Wie viel das wert ist, sagt genau authoritative:

• authoritative: true — der Referenzbestand ist das nationale Register selbst. Heute: CH und LI (SIX BankMaster), DE (Bankleitzahlendatei der Bundesbank), FI (Finance-Finland-Codes — an Bankengruppen vergeben, ein Treffer bestätigt die Gruppe), AT (OeNB-Verzeichnis), BE (Codeliste der Belgischen Nationalbank), BG (BAE-Register der Bulgarischen Nationalbank — das Urteil gilt dem Bankcode aus vier Buchstaben, IBAN-Positionen 5-8; Filialziffern werden nicht separat geprüft), SK (der prevodník der Identifikationscodes für den inländischen Zahlungsverkehr der Národná banka Slovenska). In diesen Ländern bedeutet not_in_register, dass der Code nicht vergeben ist — ein starker Grund, eine Zahlung zu stoppen. San Marino steht dort bewusst nicht: Die Liste der operativen Banken der Zentralbank nennt den Inhaber eines geführten Codes, ein Treffer ist also verified mit einem institution-Block, doch sie veröffentlicht nicht die Vergabe des ABI-Raums — ein Fehlen bleibt daher absent_from_reference_data und authoritative bleibt false. Siehe san-marinesische Bankleitzahlen.
• authoritative: false — der Referenzbestand ist unsere zusammengesetzte Bankcode-Karte aus BIC-Verzeichnissen. Ein Treffer benennt den Inhaber des passenden BIC; er beweist nicht, dass dieses Institut IBANs ausgibt. Wo Bankcodes aus Buchstaben bestehen, heißt match: "prefix" mit candidates > 1: nur ein Hinweis.

Ein Fehler auf unserer Seite wird als unavailable gemeldet, nie als Verdikt. Wenn die Referenzdaten nicht gelesen werden können — unlesbare Datenbank, nach einem fehlgeschlagenen Deploy fehlende Tabelle, Zeitüberschreitung einer Abfrage — lautet die Antwort status: "unavailable" mit reason: "lookup_failed" und register: null. Nie not_in_register: Dieses Verdikt bedeutet „kein Institut hält diesen Code", und eine Störung bei uns ist kein Beleg über Ihren Empfänger. reason trennt beide Situationen in einem einzigen Token: lookup_failed und national_register_unavailable liegen bei uns, alles andere ist eine Aussage über den Code. Alle werden gleich behandelt: weitermachen und einen Namensabgleich des Empfängers entscheiden lassen.

Nichts davon bestätigt, dass das Konto existiert, geführt wird oder einer bestimmten Person gehört. Eine strukturell gültige IBAN mit real existierendem Institut kann dennoch fabriziert sein. Zur Empfängerprüfung nutzen Sie die Verification of Payee der Banken (sepa.vop_required zeigt, wann sie vorgeschrieben ist) oder einen Namensabgleich mit Ihrer Gegenpartei — wo eine Antwort diese Lücke offenlässt, sagt next_steps es ausdrücklich.

Abwickeln oder nur als Hinweis behandeln?

Der BIC in der Antwort ist aus dem Bankcode der IBAN abgeleitet, und was diese Ableitung wert ist, hängt vollständig davon ab, was sie erzeugt hat. bic.basis sagt, welche Quelle es war, und bic.authoritative macht daraus den einen booleschen Wert, auf den eine Zahlungsverarbeitung verzweigen kann:

• basis: "national_register", authoritative: true — das nationale Register des Landes veröffentlicht diesen BIC für diesen Bankcode. Heute sind das die Schweiz, Liechtenstein, Deutschland, Österreich, Belgien, Bulgarien, die Slowakei und San Marino: Der SIX BankMaster führt für CH und LI den exakten 11-stelligen BIC je IID (BC-Nummer), die Bankleitzahlendatei der Bundesbank führt den exakten 11-stelligen BIC je BLZ, und die Register der OeNB, der Belgischen Nationalbank, das BAE-Register der Bulgarischen Nationalbank, der prevodník der Národná banka Slovenska sowie die Liste der Zentralbank von San Marino veröffentlichen den BIC des Instituts je Bankcode. San Marino ist die einzige Stelle, an der dieses Flag true ist, während bank_code_check.authoritative false ist: Die Liste der Zentralbank ordnet einem geführten Code einen BIC zu, veröffentlicht aber nicht die Vergabe des Coderaums. Das deutsche Register ist der Grund, weshalb eine Sparkasse zu ihrem eigenen BIC auflöst und nicht zum BIC8 der gemeinsamen Landesbank, und das Schweizer Register der Grund, weshalb die IID 30020 zu Crédit Mutuel de la Vallée SA (RBABCH22180) auflöst und nicht zu Entris Banking AG (RBABCH22) — das Feld benennt diese Zuordnung, es erzeugt sie nicht. Vergleichen Sie einen gelieferten BIC auf bic8: Der Filialcode ist informativ, und in einem Genossenschaftsverbund benennt er die lokale Bank, während die ersten acht Zeichen ihr Clearing-Institut benennen. Speicherbar und zur Abwicklung geeignet — mit einer Ausnahme: Ein Code, den das Register selbst als zurückgezogen führt, behält die Basis national_register, aber authoritative fällt auf false; lesen Sie bank_code_check.retired und superseded_by.
• basis: "curated_map", authoritative: false — unsere eigene gepflegte Bankcode-Karte hat die Zuordnung über einen exakten Schlüssel hergestellt. Meistens richtig und kein Vergabeakt: Keine Behörde steht dahinter.
• basis: "directory_prefix", authoritative: false — der BIC-Präfix-Rückfall. Er kann mehrere Institute gleichzeitig treffen; bank_code_check.candidates sagt wie viele, und next_steps meldet bic_is_advisory, sobald es mehr als eines ist.

Außerhalb einer national_register-Basis behandeln Sie den BIC als Hinweis: gut für Anzeige, Anreicherung und Routing-Hinweise, und vor der Speicherung als Abwicklungsanweisung mit dem Empfänger oder Ihrer Bank zu bestätigen.

bic.authoritative und bank_code_check.authoritative beantworten zwei verschiedene Fragen. In der Schweiz wurde der Unterschied früher sichtbar, heute nicht mehr: Der BIC stammt jetzt aus der Spalte des SIX BankMaster selbst, beide sind dort also true. In San Marino gehen sie weiterhin auseinander, in die andere Richtung — die Zuordnung ist die der Aufsicht (bic.authoritative: true), während der Coderaum nicht von ihr vergeben wird (bank_code_check.authoritative: false). Das eine betrifft die Existenz des Codes, das andere die Zuordnung, die den BIC erzeugt hat.

Ungültige IBAN (200)

Wenn die IBAN ungültig ist, gibt die Antwort dennoch den Statuscode 200 zurück, jedoch mit valid: false:

{
  "iban": "CH5604835012345678000",
  "valid": false,
  "error": "checksum_failed",
  "error_detail": "Modulo 97 check returned 42, expected 1.",
  "cost_usdc": 0.005
}

Fehlercodes

Codebeispiele

cURL

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "DE89 3704 0044 0532 0130 00"}'

Python

import requests
 
response = requests.post(
    "https://api.ibanforge.com/v1/iban/validate",
    json={"iban": "DE89370400440532013000"},
)
 
data = response.json()
if data["valid"]:
    print(f"Bank: {data['bic']['bank_name']}")
    print(f"Country: {data['country']['name']}")
    print(f"SEPA: {data['sepa']['member']}")
    print(f"Issuer type: {data['issuer']['type']}")
    print(f"Risk: {data['risk_indicators']['country_risk']}")
else:
    print(f"Invalid: {data['error_detail']}")

TypeScript

const response = await fetch(
  "https://api.ibanforge.com/v1/iban/validate",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ iban: "DE89370400440532013000" }),
  }
);
 
const data = await response.json();
 
if (data.valid) {
  console.log(`Bank: ${data.bic.bank_name}`);
  console.log(`SEPA: ${data.sepa.member}, VoP: ${data.sepa.vop_required}`);
  console.log(`Issuer: ${data.issuer.type} — ${data.issuer.name}`);
  console.log(`Country risk: ${data.risk_indicators.country_risk}`);
} else {
  console.log(`Invalid: ${data.error_detail}`);
}