IBANforge API

Postman Collection herunterladen

IBANforge ist eine schnelle, zuverlässige API für IBAN-Validierung und BIC/SWIFT-Abfrage. Sie deckt 89 Länder ab und bietet Echtzeit-Prüfsummenverifizierung, BBAN-Strukturanalyse, angereicherte Institutsdaten von GLEIF und weiteren öffentlichen Quellen (SWIFT-Verzeichnis, Bundesbank, SIX, NBP), SEPA-Konformitätsinformationen, Emittentenklassifizierung (Bank vs. E-Geld-Institut/Neobank), Sanktions- und Compliance-Screening mit Risiko-Score von 0–100 sowie exklusive Schweizer Clearing-Daten (BC-Nummer) aus dem SIX BankMaster.

Hier anfangen. Die Erste Schritte gehen den ganzen Weg in zehn Minuten — den Aufruf ohne Schlüssel, den kostenlosen Schlüssel, jeden Block der Antwort bei seinem echten Namen, einen Stapel von 100 und die beiden Arten von Fehler. Jedes curl auf dieser Seite wurde wirklich ausgeführt, und jede Antwort ist die, die die API gegeben hat.

Kostenlos starten, ganz ohne Schlüssel. Zwei Endpoints lösen ein ganzes Problem gratis: /v1/reference/validate prüft Zahlungsreferenzen (RF/ISO 11649, Schweizer QRR, belgische OGM, finnische viitenumero) mit belegtem Verdikt, und /v1/address/check prüft eine strukturierte ISO-20022-Adresse gegen die SPS-, T2- oder Fedwire-Regeln vor den Umstellungen im November 2026.

Basis-URL

https://api.ibanforge.com

Alle Endpunkte werden über HTTPS bereitgestellt. HTTP-Anfragen werden automatisch umgeleitet.

Authentifizierung

Vor allen dreien: Die ersten 25 Aufrufe pro Tag brauchen gar nichts. POST /v1/iban/validate mit einer echten iban und ohne Schlüssel wird vollständig beantwortet, 25-mal pro Tag für die Adresse, von der er kommt. Die Antwort enthält einen trial-Block mit der Zahl der heute verbleibenden Aufrufe und der einen Anfrage, die einen kostenlosen Schlüssel liefert. Eine Kostprobe, keine Stufe: über 25/Tag antwortet der Endpunkt wieder mit 402 und cause.reason: "trial_exhausted".

Danach drei Wege hinein — wählen Sie, was passt; Ihre App oder Ihr Agent landet nie in einer Sackgasse:

1. Kostenloser API-Schlüssel — 25 Anfragen/Monat ohne E-Mail. Generieren Sie einen per POST ohne Body und senden Sie Authorization: Bearer ifk_.... Mit einem Code per E-Mail beanspruchen Sie denselben Schlüssel für 200/Monat, ohne Kreditkarte.
2. Prepaid-Guthabenpakete — 1k = 4 $, 5k = 20 $, 25k = 80 $. Sie verfallen nie und sind per Karte oder in USDC kaufbar (POST /v1/credits/buy/1k|5k|25k). Siehe Preise.
3. x402-Mikrozahlungen — vollständig autonome Bezahlung pro Aufruf in USDC für Agenten, ganz ohne Konto. Siehe x402-Leitfaden.

Eine Anfrage ohne gültigen Schlüssel oder Zahlung erhält eine 402-Antwort mit maschinenlesbaren Anweisungen für alle drei Wege — autonome Agenten können sich selbst onboarden.

Endpunkte im Überblick

Schnellbeispiel

Ohne Schlüssel, ohne Anmeldung — dieser Aufruf funktioniert so, wie er ist, 25-mal pro Tag für die Adresse, von der er kommt:

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "CH10 0023 0000 0000 1234 5"}'

Die Antwort enthält dann einen zusätzlichen trial-Block:

"trial": {
  "calls_used_today": 1,
  "calls_left_today": 24,
  "daily_limit": 25,
  "resets": "midnight UTC",
  "free_key": "POST https://api.ibanforge.com/v1/keys/generate with {\"source\":\"api-trial\"} — no e-mail, no card, nothing to confirm: an ifk_ key worth 25 requests a MONTH, on every endpoint (these 25 are a DAY, on this route only). One call at POST /v1/keys/claim, key in the Authorization header, raises the same key to 200 a month.",
  "docs": "https://ibanforge.com/docs/api-keys?src=api-trial"
}

Ab dem 11. Aufruf am Tag holen Sie sich den kostenlosen Schlüssel — ein einziger POST, keine Karte — und ergänzen dieselbe Anfrage um Authorization: Bearer ifk_....

Antwort:

{
  "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"
  },
  "sepa": {
    "member": true,
    "schemes": ["SCT", "SDD"],
    "vop_required": false
  },
  "issuer": {
    "type": "bank",
    "name": "UBS Switzerland AG"
  },
  "risk_indicators": {
    "issuer_type": "bank",
    "country_risk": "standard",
    "test_bic": false,
    "sepa_reachable": true,
    "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
}

Kostenloses Testen

Verwenden Sie den Endpunkt /v1/demo, um die API ohne Zahlungseinrichtung zu testen:

curl https://api.ibanforge.com/v1/demo

Dieser gibt vorvalidierte Beispiel-IBANs aus mehreren Ländern zurück, damit Sie das Antwortformat erkunden können.

Nächste Schritte

• Erste Schritte — von null zum ersten Stapel von 100, in zehn Minuten
• API-Schlüssel — holen Sie Ihren kostenlosen Schlüssel, 25/Monat ohne E-Mail, 200/Monat nach E-Mail-Bestätigung
• Einzelne IBAN validieren — vollständige Endpunkt-Referenz
• Stapelvalidierung — bis zu 100 IBANs auf einmal validieren
• BIC/SWIFT-Abfrage — Institutsdaten nach BIC-Code suchen
• Compliance-Prüfung — Sanktionen, FATF, VoP und Risiko-Score
• Schweizer Clearing — BC-Nummer, SIC und Instant Payments
• x402-Mikrozahlungen — wie autonome Bezahlung funktioniert
• MCP-Integration — IBANforge mit KI-Agenten verbinden
• Fehlerreferenz — alle Fehlercodes und Fehlerbehebung