Doku

Dokumentation & API-Referenz

So nutzen Sie ibanworld.de: IBAN prüfen, BIC suchen, Bank finden – plus vollständige REST-API-Referenz mit Beispielen.

IBAN prüfen

Prüfen Sie, ob eine IBAN strukturell gültig ist, und ermitteln Sie bei deutschen IBANs die passende Bank.

Validator öffnen

Gehen Sie zu ibanworld.de — das Eingabefeld befindet sich ganz oben auf der Seite.

IBAN eingeben oder einfügen

Leerzeichen werden beim Tippen automatisch entfernt, Sie können die IBAN also genau so einfügen, wie sie Ihre Bank formatiert hat.

Ergebnis lesen

Sie sehen, ob die Prüfsumme (MOD-97 nach ISO 13616) gültig ist, das Land, die SEPA-Zugehörigkeit sowie bei deutschen IBANs Bankname, BIC und Ort. Jedes Feld hat einen Kopieren-Button.

BIC / SWIFT-Code suchen

Prüfen Sie einen bestehenden BIC oder nutzen Sie die Banknamen-Suche auf derselben Seite.

BIC-Suche öffnen

Gehen Sie zu ibanworld.de/bic-suche.

BIC prüfen

Geben Sie einen 8- oder 11-stelligen BIC ein (z. B. COBADEFFXXX), um Bankcode, Land, Standort und Filiale entschlüsselt zu sehen.

Bank per Name finden

Nutzen Sie auf derselben Seite das zweite Feld, um deutsche Banken per Name oder Bankleitzahl zu suchen — mindestens 3 Zeichen eingeben.

Länder-Referenz

Die Länderseite listet alle 77 unterstützten Länder mit IBAN-Länge, SEPA-Status und einem direkt testbaren Beispiel.

REST-API — Übersicht

Dieselbe Validierungslogik, die die Website antreibt, steht als JSON-REST-API zur Verfügung. Für den kostenlosen Tarif ist kein API-Schlüssel erforderlich.

Basis-URL: https://ibanworld.de/api

Rate-Limit (kostenlos): 5 Anfragen pro IP-Adresse und Kalendertag (UTC), über alle /api/*-Endpunkte zusammen. Jede Antwort enthält die Header X-RateLimit-Limit, X-RateLimit-Remaining und X-RateLimit-Reset. Höheres Limit nötig? Kontaktieren Sie uns.

Format: Alle Antworten sind application/json, ohne Wrapper — die Ergebnisfelder liegen auf oberster Ebene.

POST /api/validate

Validiert eine IBAN. Akzeptiert für schnelle Tests im Browser auch GET /api/validate?iban=....

Feld	Typ	Pflicht	Beschreibung
iban	string	ja	Die zu validierende IBAN. Leerzeichen werden ignoriert.

POST/api/validate

curl

curl -X POST https://ibanworld.de/api/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "DE89370400440532013000"}'

response.json

{
  "valid": true,
  "iban": "DE89370400440532013000",
  "formatted": "DE89 3704 0044 0532 0130 00",
  "country": "Germany",
  "country_code": "DE",
  "sepa": true,
  "details": { "blz": "37040044", "account_number": "0532013000" },
  "bank": { "name": "Commerzbank", "bic": "COBADEFFXXX", "city": "Köln" }
}

GET /api/bic/{bic}

Validiert einen BIC/SWIFT-Code und liefert, falls bekannt, die passende Bank.

GET/api/bic/COBADEFFXXX

response.json

{
  "valid": true,
  "bank_code": "COBA",
  "country_code": "DE",
  "location_code": "FF",
  "branch_code": "XXX",
  "bank": { "name": "Commerzbank", "bic": "COBADEFFXXX", "city": "Köln" }
}

GET /api/banks/search?q=

Sucht deutsche Banken per Name oder Bankleitzahl. Mindestens 3 Zeichen; bis zu 20 Ergebnisse.

Feld	Typ	Pflicht	Beschreibung
q	string	ja	Suchbegriff (Bankname oder Bankleitzahl), min. 3 Zeichen.

GET/api/banks/search?q=Commerzbank

response.json

{
  "results": [
    { "name": "Commerzbank", "blz": "37040044", "bic": "COBADEFFXXX", "city": "Köln" }
  ]
}

Fehler & Statuscodes

422missing_iban — das Feld iban war leer oder wurde nicht gesendet.

200valid: false — eine wohlgeformte, aber ungültige Anfrage liefert HTTP 200 mit einem error-Feld, das den Grund nennt (z. B. checksum, wrong_length, unknown_country).

429rate_limit_exceeded — Sie haben Ihre 5 kostenlosen Anfragen für heute aufgebraucht. Siehe X-RateLimit-Reset, oder kontaktieren Sie uns für einen höheren Tarif.