IBANforge

API IBANforge

Telecharger la collection Postman

IBANforge est une API rapide et fiable pour la validation IBAN et la recherche BIC/SWIFT. Elle couvre 89 pays avec vérification de checksum en temps réel, analyse de la structure BBAN, données institutionnelles enrichies via GLEIF et autres sources publiques (annuaire SWIFT, Bundesbank, SIX, NBP), informations de conformité SEPA, classification de l'émetteur (banque vs. EMI/néobanque), screening sanctions & conformité avec score de risque 0–100, et les données exclusives de clearing suisse (BC-Nummer) issues du SIX BankMaster.

URL de base

https://api.ibanforge.com

Tous les endpoints sont servis en HTTPS. Les requetes HTTP sont automatiquement redirigees.

Authentification

Trois portes d'entrée — choisissez ce qui vous convient, votre app ou votre agent ne tombe jamais sur un cul-de-sac :

  1. Clé API gratuite — 200 requêtes/mois, sans carte bancaire. Générez-la avec un simple POST, puis envoyez Authorization: Bearer ifk_... avec chaque requête.
  2. Packs de crédits prépayés — 1k = 5 $, 5k = 20 $, 25k = 80 $. Ils n'expirent jamais, achetables par carte ou en USDC (POST /v1/credits/buy/1k|5k|25k). Voir les tarifs.
  3. Micropaiements x402 — paiement à l'appel entièrement autonome en USDC pour les agents, sans aucun compte. Voir le guide x402.

Une requête sans clé valide ni paiement reçoit une réponse 402 avec des instructions lisibles par machine pour les trois voies — les agents autonomes s'auto-embarquent.

Endpoints en un coup d'oeil

EndpointMethodeCoutDescription
/v1/iban/validatePOST$0.005Valider un IBAN unique
/v1/iban/batchPOST$0.002/IBANValider jusqu'a 100 IBAN
/v1/bic/:codeGET$0.003Rechercher un code BIC/SWIFT
/v1/iban/compliancePOST$0.02Sanctions, FATF, joignabilité SEPA/VoP + score de risque 0–100
/v1/ch/clearing/:iidGET$0.003Recherche BC-Nummer / IID suisse (SIX BankMaster)
/v1/demoGETGratuitExemples de validation (sans paiement)
/healthGETGratuitVerification de l'etat du service

Exemple rapide

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

Reponse :

{
  "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
}

Test gratuit

Utilisez le endpoint /v1/demo pour tester l'API sans configuration de paiement :

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

Cela renvoie des exemples d'IBAN pre-valides de plusieurs pays afin que vous puissiez explorer le format de reponse.

Etapes suivantes