IBANforge

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.

Basis-URL

https://api.ibanforge.com

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

Authentifizierung

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

  1. Kostenloser API-Schlüssel — 200 Anfragen/Monat, keine Kreditkarte. Generieren Sie einen mit einem einzigen POST und senden Sie dann Authorization: Bearer ifk_... mit jeder Anfrage.
  2. Prepaid-Guthabenpakete — 1k = 5 $, 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

EndpunktMethodeKostenBeschreibung
/v1/iban/validatePOST$0.005Einzelne IBAN validieren
/v1/iban/batchPOST$0.002/IBANBis zu 100 IBANs validieren
/v1/bic/:codeGET$0.003BIC/SWIFT-Code abfragen
/v1/iban/compliancePOST$0.02Sanktionen, FATF, SEPA/VoP-Erreichbarkeit + Risiko-Score 0–100
/v1/ch/clearing/:iidGET$0.003Schweizer BC-Nummer / IID abfragen (SIX BankMaster)
/v1/demoGETKostenlosBeispielvalidierungen (keine Zahlung erforderlich)
/healthGETKostenlosService-Gesundheitsprüfung

Schnellbeispiel

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

Antwort:

{
  "iban": "CH1000230000000012345",
  "valid": true,
  "country": {
    "code": "CH",
    "name": "Switzerland"
  },
  "check_digits": "10",
  "bban": {
    "bank_code": "00230",
    "account_number": "000000012345"
  },
  "bic": {
    "code": "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.005
}

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