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.

Commencez ici. La prise en main parcourt tout le chemin en dix minutes — l'appel sans clé, la clé gratuite, chaque bloc de la réponse lu par son vrai nom, un lot de 100 et les deux sortes d'erreur. Chaque curl de cette page a réellement été exécuté, et chaque réponse est celle que l'API a rendue.

Commencez gratuitement, sans même une clé. Deux endpoints règlent un problème entier sans rien payer : /v1/reference/validate contrôle les références de paiement (RF/ISO 11649, QRR suisse, OGM belge, viitenumero finlandais) avec un verdict sourcé, et /v1/address/check contrôle une adresse ISO 20022 structurée contre les règles SPS, T2 ou Fedwire avant les échéances de novembre 2026.

URL de base

https://api.ibanforge.com

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

Authentification

Avant toutes les trois : les 25 premiers appels du jour ne demandent rien. POST /v1/iban/validate avec un vrai iban et sans clé est servi en entier, 25 fois par jour pour l'adresse d'où il vient. La réponse porte un bloc trial qui dit combien il en reste aujourd'hui et la requête unique qui donne une clé gratuite. C'est une dégustation, pas un palier : au-delà de 25 par jour, l'endpoint répond de nouveau 402, avec cause.reason: "trial_exhausted".

Ensuite, 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 — 25 requêtes/mois sans e-mail. Générez-la avec un POST sans corps, puis envoyez Authorization: Bearer ifk_.... Réclamer cette même clé avec un code reçu par e-mail porte le quota à 200/mois, sans carte.
2. Packs de crédits prépayés — 1k = 4 $, 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

Exemple rapide

Sans clé, sans inscription — cet appel fonctionne tel quel, 25 fois par jour pour l'adresse d'où il vient :

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

La réponse porte alors un bloc trial supplémentaire :

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

Au-delà de 25 appels par jour, prenez la clé gratuite — un seul POST, sans carte — et ajoutez Authorization: Bearer ifk_... à la même requête.

Reponse :

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

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

• Prise en main — de zéro au premier lot de 100, en dix minutes
• Clés API — obtenez votre clé gratuite, 25/mois sans e-mail, 200/mois après confirmation par e-mail
• Valider un IBAN unique — reference complete du endpoint
• Validation par lot — valider jusqu'a 100 IBAN en une seule requete
• Recherche BIC/SWIFT — rechercher les donnees d'un etablissement par code BIC
• Contrôle de conformité — sanctions, FATF, VoP et score de risque
• Clearing suisse — BC-Nummer, SIC et paiements instantanés
• Micropaiements x402 — fonctionnement du paiement autonome
• Integration MCP — connecter IBANforge a des agents IA
• Reference des erreurs — tous les codes d'erreur et depannage