GET /v1/iban?iban=DE89370400440532013000
{ "iban": "DE89370400440532013000", "gueltig": true, "land": "DE", "blz": "37040044", "konto": "0532013000" }
Die Überweisung geht raus und kommt Tage später zurück — im Kontofeld stand ein Zahlendreher, den beim Abtippen niemand gesehen hat. Bei einer Lastschrift wird es teurer: Deine Bank stellt dir die Rücklastschrift in Rechnung, dein Kunde bekommt eine Mahnung für Geld, das er längst zahlen wollte, und jemand aus der Buchhaltung telefoniert eine Stunde hinter einer einzigen falschen Ziffer her.
Die Prüfung kennt die feste Stellenzahl für 35 Länder und vergleicht sie, bevor sie überhaupt zu rechnen anfängt. Bei einer abgeschnittenen IBAN bekommst du deshalb nicht „Prüfsumme falsch“, sondern beide Zahlen: die gezählte Länge und die, die für das Land vorgesehen ist. Kurze und lange deutsche IBANs gibt es nicht — 22 Stellen oder ungültig.
| Stellen | Länder |
|---|---|
| 15 | Norwegen (NO) |
| 16 | Belgien (BE) |
| 18 | Dänemark (DK), Finnland (FI), Niederlande (NL) |
| 19 | Slowenien (SI) |
| 20 | Österreich (AT), Estland (EE), Litauen (LT), Luxemburg (LU) |
| 21 | Schweiz (CH), Kroatien (HR), Lettland (LV), Liechtenstein (LI) |
| 22 | Deutschland (DE), Bulgarien (BG), Großbritannien (GB), Irland (IE) |
| 24 | Andorra (AD), Rumänien (RO), Schweden (SE), Slowakei (SK), Spanien (ES), Tschechien (CZ) |
| 25 | Portugal (PT) |
| 26 | Island (IS) |
| 27 | Frankreich (FR), Griechenland (GR), Italien (IT), Monaco (MC), San Marino (SM) |
| 28 | Polen (PL), Ungarn (HU), Zypern (CY) |
| 31 | Malta (MT) |
Fürs Eingabefeld: 34 Zeichen ist die weltweite Obergrenze nach ISO 13616 — ein maxlength darunter schneidet gültige IBANs ab. Leerzeichen und Bindestriche aus der Zwischenablage darfst du stehen lassen; sie werden vor der Prüfung entfernt, zählen im Feld aber mit, und der Parameter nimmt bis zu 64 Zeichen an. Für die Anzeige liefert die Antwort die Vierergruppierung im Feld formatiert gleich mit.
Nicht in der Liste stehen SEPA-Randfälle wie Vatikanstadt und Gibraltar sowie alle IBAN-Länder außerhalb Europas — Türkei, Brasilien, Vereinigte Arabische Emirate. Sie werden abgelehnt, auch wenn ihre Prüfsumme rechnerisch stimmt. Der Grund lautet dann Land XX nicht unterstuetzt und nicht „ungültig“; gib diesen Unterschied im Formular genauso weiter.
Bei einer abgelehnten IBAN steht im Feld grund, woran es lag. Geprüft wird in der Reihenfolge der Tabelle, der erste Treffer gewinnt — du bekommst also immer genau einen Grund zurück. Jeder der vier Fälle verlangt eine andere Reaktion im Formular, und mit „Bitte prüfe deine Eingabe“ ist dem Nutzer in keinem davon geholfen.
| Grund | Was dahintersteckt | Sinnvolle Reaktion |
|---|---|---|
Format ungueltig | Weniger als 5 oder mehr als 34 Zeichen, Sonderzeichen, oder der Anfang passt nicht auf das Muster „zwei Buchstaben, zwei Ziffern“ | Meist steht dort eine alte Kontonummer statt einer IBAN — Feld leeren und ein Beispiel einblenden |
Land XX nicht unterstuetzt | Der Aufbau stimmt, aber das Länderkürzel ist nicht hinterlegt | Klar sagen, dass dieses Land nicht geprüft werden kann — nicht als falsche IBAN melden |
Laenge N, fuer XX sind es M | Zeichen fehlen oder es sind zu viele | Beide Zahlen stehen in der Antwort: „21 Stellen eingegeben, für DE sind es 22.“ |
Pruefsumme falsch | Die Länge passt, die mod-97-Rechnung geht nicht auf | Klassischer Zahlendreher — den Nutzer bitten, die IBAN Stelle für Stelle gegen den Beleg abzugleichen |
Bei einer gültigen deutschen IBAN kommen Bankleitzahl (Stelle 5 bis 12) und Kontonummer getrennt zurück. Achtung beim Übernehmen: Die Kontonummer kommt ohne führende Nullen, aus 0532013000 wird 532013000. Braucht dein Altsystem die zehnstellige Form, füllst du links wieder mit Nullen auf. Bei IBANs anderer Länder fehlen beide Felder in der Antwort komplett — zerlegt wird nur DE.
Zwei Fehlerformen, nicht eine: Ein fehlender oder über 64 Zeichen langer Parameter kommt als HTTP 400 mit missing_iban beziehungsweise too_long zurück, noch vor der Abrechnung. Alles andere kommt mit HTTP 200 — auch die ungültige IBAN, dann eben mit gueltig: false und einem grund. Dieser Aufruf zählt auf dein Kontingent.
Die IBAN wird mit der internationalen mod-97-Prüfsumme (ISO 13616) validiert — dieselbe Rechnung, die Banken verwenden. Zahlendreher und Tippfehler fallen damit mathematisch sicher auf. Länge und Aufbau werden je SEPA-Land geprüft.
Nein — das kann keine IBAN-Prüfung, das wissen nur die Banken selbst. Die Prüfung stellt sicher, dass die IBAN formal gültig ist. Das fängt die praktisch häufigste Fehlerquelle ab: falsch abgetippte Bankverbindungen.
Nein. Die Prüfung ist eine reine Rechnung im Speicher, die IBAN wird weder geloggt noch gespeichert. Es gibt keinen Abruf bei Dritten — die Daten verlassen den Server nicht.
Alle SEPA-Länder mit ihren jeweiligen Längen- und Formatregeln — von DE mit 22 Stellen bis Malta mit 31. Für deutsche IBANs werden zusätzlich Bankleitzahl und Kontonummer extrahiert.
Ja — die Antwort kommt in Millisekunden, schnell genug für die Validierung beim Tippen oder beim Verlassen des Felds. Ein Aufruf pro Prüfung, das freie Kontingent reicht für die meisten Formulare locker.
Aktuell ist alles in der Beta komplett kostenlos — keine Kreditkarte, keine Laufzeit. Nach dem Verkaufsstart beginnen die Tarife bei 3,50 € pro Monat (10.000 Aufrufe) — bewusst rund die Hälfte des üblichen Marktpreises. Wer in der Beta dabei ist, wird vor jeder Umstellung informiert.
E-Mail-Adresse in das Formular auf dieser Seite eintragen — der API-Schlüssel erscheint sofort, ohne Bestätigungs-Wartezeit. Damit hast du 1.000 Aufrufe pro Monat frei. Der Schlüssel wird als Hash gespeichert und nur einmal angezeigt, also direkt sicher ablegen.
E-Mail eintragen, Schlüssel erscheint sofort auf der Seite. Kein Konto, keine Kreditkarte, keine Freischaltung durch uns.
Ein einziger HTTP-Aufruf mit deinem Schlüssel im Kopf — aus jeder Programmiersprache, jedem Framework, jedem Automatisierungswerkzeug.
Du bekommst sauberes JSON oder die fertige Datei zurück. Fehler kommen als klare deutsche Meldung, nicht als Rätsel.
GET /v1/iban?iban=DE89370400440532013000
Wir legen die Preise jetzt schon offen, damit du planen kannst. Beta-Nutzer werden rechtzeitig informiert, bevor sich etwas ändert — niemand wird automatisch in einen bezahlten Tarif überführt.
Alle Preise zuzüglich Umsatzsteuer. Monatlich kündbar, keine Mindestlaufzeit, keine Einrichtungsgebühr.
Verwandt: USt-ID-Prüfung · E-Mail-Validierung