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 Bedarf | Einstieg |
|---|---|
| Eine Prüfung in Buchhaltungs- oder ERP-Software einbauen | Erster Aufruf und Auswertung |
| Eine Lieferantendatei für die Migration vorbereiten | Dateiprüfung mit getrennten Vorschlägen |
| Eine per OCR extrahierte IBAN prüfen | Anwendungsfälle, Grenzen und Prüffälle |
| Ohne vollständigen eigenen Client automatisieren | Rezepte für Python, SDK, Sheets und n8n |
| Einem Agenten Werkzeuge bereitstellen | MCP 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.
validundchecks: Format, Prüfsumme und tatsächlich ausgeführte Prüfungen.not_checkedbedeutet nichtpass.bank_code_checkundbic: 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.
| Route | Zweck | Zugang | x402 |
|---|---|---|---|
POST /v1/iban/validate | Struktur und Referenzen für eine IBAN | Test ohne Schlüssel auf dieser Route, danach Schlüssel oder autorisierter kostenpflichtiger Zugang | 0.005 USDC |
POST /v1/iban/batch | Bis zu 100 IBAN, ein Ergebnis je Eingabe | Eine Kontingenteinheit pro IBAN | 0.002 USDC / IBAN |
GET /v1/bic/:code | BIC-Suche | Schlüssel oder autorisierter kostenpflichtiger Zugang | 0.003 USDC |
GET /v1/ch/clearing/:iid | Schweizer Clearing-Referenz | Schlüssel oder autorisierter kostenpflichtiger Zugang | 0.003 USDC |
POST /v1/iban/compliance | Indikatoren zu Institut und Land | Schlüssel oder autorisierter kostenpflichtiger Zugang; kein Empfänger-Screening | 0.02 USDC |
GET oder POST /v1/iban/format | Struktur und Prüfsumme ohne Banksuche | Kostenlos, ohne Schlüssel | 0 |
GET oder POST /v1/reference/validate | Prüfsumme unterstützter Zahlungsreferenzen | Kostenlos, ohne Schlüssel | 0 |
POST /v1/address/check | Adressformat nach gewähltem Schema und belegten Regeln | Kostenlos, ohne Schlüssel | 0 |
POST /v1/ch/qr-bill/check | Struktur des Inhalts einer Schweizer QR-Rechnung | Kostenlos, ohne Schlüssel | 0 |
POST /v1/audit/upload | Prüfung einer CSV- oder Excel-Datei | Kostenlose Vorschau; vollständiger Bericht zum angezeigten Preis | Eigener Dateipreis |
GET /v1/demo | Öffentliche Beispielantworten | Kostenlos; prüft keinen Schlüssel | 0 |
GET /health | Öffentlicher Dienststatus | Kostenlos | 0 |
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.