Zum Inhalt springen
IBANforge

IBANforge API

IBANforge prüft die Struktur einer IBAN und sucht verfügbare Bankreferenzen: Institut, BIC und Herkunft der Information. Die Ergebnisse unterscheiden einen bestätigten Code, einen im aussagekräftigen Register fehlenden Code und unzureichende oder nicht verfügbare Referenzen. Die Abdeckung nach Quelle erklärt diese Unterschiede.

Postman-Sammlung für die ersten Aufrufe herunterladen

Der Dienst bestätigt weder die Existenz des Kontos noch dessen Inhaber. Sanktionsindikatoren betreffen das Institut und das Land, nicht den genannten Zahlungsempfänger. Ein gültiges Ergebnis ist keine Zahlungsfreigabe.

Den passenden Einstieg wählen

Ihr BedarfEinstieg
Eine Prüfung in Buchhaltungs- oder ERP-Software einbauenErster Aufruf und Auswertung
Eine Lieferantendatei für die Migration vorbereitenDateiprüfung mit getrennten Vorschlägen
Eine per OCR extrahierte IBAN prüfenAnwendungsfälle, Grenzen und Prüffälle
Ohne vollständigen eigenen Client automatisierenRezepte für Python, SDK, Sheets und n8n
Einem Agenten Werkzeuge bereitstellenMCP und Zugang je Transport

Im Playground können Sie eine Antwort im Browser ansehen. Für eine ganze Datei ohne Integration zeigt die Prüfseite einen Musterbericht und eine kostenlose Vorschau vor einem Kauf.

Erster Aufruf ohne Schlüssel

curl --silent --show-error --include \
  --request POST https://api.ibanforge.com/v1/iban/validate \
  --header 'Content-Type: application/json' \
  --data '{"iban":"CH10 0023 0000 0000 1234 5"}'

Diese IBAN ist ein Dokumentationsbeispiel, kein Zahlungsauftrag. Der REST-Test umfasst 25 Validierungen pro ISO-Woche in UTC und Quelladresse, nur auf dieser Route. Der Block trial nennt Restkontingent und Rücksetzungszeit. In einem gemeinsam genutzten Netzwerk kann das Kontingent bereits verbraucht sein; 402 trial_exhausted ist kein IBAN-Befund.

Beispiel für den trial-Zähler ansehen

Fiktives, reproduzierbares Beispiel: erster Aufruf einer Adresse am 24. September 2026. Das Rücksetzungsdatum gehört zu diesem historischen Beispiel; lesen Sie für Ihren Aufruf die tatsächlich zurückgegebenen Werte. Dieser Block beschreibt den Vertrag, kein reales Kontingent.

{
"trial": {
  "calls_used_this_week": 1,
  "calls_left_this_week": 24,
  "weekly_limit": 25,
  "resets": "Monday 00:00 UTC",
  "resets_at": "2026-09-28T00:00:00Z",
  "free_key": "POST https://api.ibanforge.com/v1/keys/generate with {\"source\":\"api-trial\"} — no e-mail, no card, nothing to confirm: it returns an ifk_ key that works on every endpoint, good for 200 requests a month once claimed (POST /v1/keys/claim, key in the Authorization header, with a code mailed to an address you read). Unclaimed, the key starts at 25 requests a month",
  "docs": "https://ibanforge.com/docs/api-keys?src=api-trial"
}
}

Die ersten Schritte erklären den wiederverwendbaren Schlüssel, den ersten Stapel und Fehler. Ein per E-Mail-Code beanspruchter kostenloser Schlüssel bietet 200 Anfragen pro Monat. Ohne Adresse beginnt er normalerweise mit 25 monatlichen Anfragen; lesen Sie immer monthly_limit und eine mögliche notice.

Das Ergebnis auf mehreren Ebenen lesen

  • HTTP: Wurde die Anfrage verarbeitet? Eine Kontingentablehnung bedeutet keine ungültige IBAN.
  • valid und checks: Format, Prüfsumme und tatsächlich ausgeführte Prüfungen. not_checked bedeutet nicht pass.
  • bank_code_check und bic: Registerbefund, Aussagekraft, Quelle und Stand. Ein fehlender Eintrag in einer Teilquelle beweist keine Nichtzuteilung.
  • Grenzen auf Kontoebene: Existenz des Kontos, Kontoinhaber und Sanktionen des Empfängers werden damit nicht geprüft.

Die Validierungsreferenz erklärt die Felder, die Fehlerreferenz die Ablehnungen. Halten Sie ursprüngliche Bankverbindungen und Vorschläge in Ihrer Integration getrennt.

Wichtige Routen

HTTPS-Basis: https://api.ibanforge.com. Den vollständigen Vertrag finden Sie in der OpenAPI-Referenz und der Postman-Collection.

Die folgenden x402-Preise gelten nur bei gewählter Zahlung pro Aufruf. Sie werden nicht zusätzlich zum REST-Test oder zu Aufrufen innerhalb des Schlüsselkontingents oder Prepaid-Guthabens berechnet. Siehe x402 für die Zahlung und Preise für aktuelle Angebote.

RouteZweckZugangx402
POST /v1/iban/validateStruktur und Referenzen für eine IBANTest ohne Schlüssel auf dieser Route, danach Schlüssel oder autorisierter kostenpflichtiger Zugang0.005 USDC
POST /v1/iban/batchBis zu 100 IBAN, ein Ergebnis je EingabeEine Kontingenteinheit pro IBAN0.002 USDC / IBAN
GET /v1/bic/:codeBIC-SucheSchlüssel oder autorisierter kostenpflichtiger Zugang0.003 USDC
GET /v1/ch/clearing/:iidSchweizer Clearing-ReferenzSchlüssel oder autorisierter kostenpflichtiger Zugang0.003 USDC
POST /v1/iban/complianceIndikatoren zu Institut und LandSchlüssel oder autorisierter kostenpflichtiger Zugang; kein Empfänger-Screening0.02 USDC
GET oder POST /v1/iban/formatStruktur und Prüfsumme ohne BanksucheKostenlos, ohne Schlüssel0
GET oder POST /v1/reference/validatePrüfsumme unterstützter ZahlungsreferenzenKostenlos, ohne Schlüssel0
POST /v1/address/checkAdressformat nach gewähltem Schema und belegten RegelnKostenlos, ohne Schlüssel0
POST /v1/ch/qr-bill/checkStruktur des Inhalts einer Schweizer QR-RechnungKostenlos, ohne Schlüssel0
POST /v1/audit/uploadPrüfung einer CSV- oder Excel-DateiKostenlose Vorschau; vollständiger Bericht zum angezeigten PreisEigener Dateipreis
GET /v1/demoÖffentliche BeispielantwortenKostenlos; prüft keinen Schlüssel0
GET /healthÖffentlicher DienststatusKostenlos0

Prepaid-Pakete: 1.000 Credits = 4 $; 5.000 = 20 $; 25.000 = 80 $. Credits verfallen nicht; eine Validierung oder Suche kostet einen Credit, ein Batch einen je IBAN. Kartenzahlung und USDC stehen unter Preise. Die Dateiprüfung hat einen eigenen, von der Dateigröße abhängigen Preis, der mit der kostenlosen Vorschau angezeigt wird; diese Aufrufpreise enthalten ihn nicht.

Preise und Zugangsgrenzen beschreiben die Angebote. Eine 402-Antwort erklärt die Möglichkeiten; sie ermächtigt eine Automatisierung weder zum Kauf von Guthaben noch zu einer Zahlung.