Aller au contenu
IBANforge

API IBANforge

IBANforge contrôle la structure d’un IBAN et recherche les références bancaires disponibles : banque, BIC et source de l’information. Les résultats distinguent un code confirmé, un code absent d’un registre qui permet de conclure et une référence insuffisante ou indisponible. La couverture par source explique ces différences.

Télécharger les premiers appels Postman

Le service ne confirme ni l’existence du compte ni son titulaire. Les indicateurs de sanctions portent sur l’établissement et le pays, pas sur le bénéficiaire nommé. Une réponse valide ne constitue pas une autorisation de paiement.

Choisir le parcours adapté

Votre besoinPoint de départ
Ajouter un contrôle à un logiciel de comptabilité ou d’ERPPremier appel et lecture du résultat
Reprendre un fichier fournisseurs avant migrationRevue de fichier avec propositions séparées
Contrôler un IBAN après extraction OCRUsages, limites et cas à revoir
Automatiser sans développer un client completRecettes Python, SDK, Sheets et n8n
Fournir des outils à un agentMCP et accès par transport

Le playground permet d’examiner une réponse dans le navigateur. Pour un fichier entier sans intégration, la page d’audit présente un rapport d’exemple et un aperçu gratuit avant tout achat.

Premier appel sans clé

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

Cet IBAN est un exemple documentaire, pas une instruction de paiement. L’essai REST sert 25 validations par semaine ISO UTC et par adresse source, sur cette route uniquement. La réponse trial précise le solde et la remise à zéro. Sur un réseau partagé, ce solde peut déjà être consommé ; un 402 trial_exhausted n’est pas un verdict sur l’IBAN.

Voir un exemple du décompte trial

Exemple fictif et reproductible : premier appel d’une adresse le 24 septembre 2026. La date de remise à zéro ci-dessous correspond à cet exemple historique ; pour votre appel, lisez les valeurs effectivement renvoyées. Ce bloc décrit le contrat, pas le solde d’un compte réel.

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

Le guide de prise en main explique le passage à une clé conservée, le premier lot et les erreurs. Une clé gratuite réclamée par code reçu par e-mail donne 200 requêtes par mois. Sans adresse, elle commence normalement à 25 requêtes mensuelles ; lisez toujours monthly_limit et l’éventuelle notice.

Lire un résultat à plusieurs niveaux

  • HTTP : la requête a-t-elle été traitée ? Un refus de quota n’est pas un IBAN invalide.
  • valid et checks : format, somme de contrôle et contrôles effectivement réalisés. not_checked n’est pas pass.
  • bank_code_check et bic : verdict du registre, autorité de la référence, source et date. Une absence dans une source partielle ne prouve pas un code non attribué.
  • Limites du compte : existence, titulaire et sanctions du bénéficiaire ne sont pas vérifiés par ces données bancaires.

La référence de validation décrit les champs ; les erreurs décrivent les refus. Gardez les coordonnées d’origine et les propositions séparées dans votre intégration.

Routes principales

Base HTTPS : https://api.ibanforge.com. Le contrat complet est dans la référence OpenAPI et la collection Postman.

Les prix x402 ci-dessous concernent uniquement le paiement à l’appel que vous choisissez. Ils ne s’ajoutent pas à l’essai REST ni aux appels couverts par le quota ou les crédits prépayés d’une clé. Voir x402 pour le paiement et les tarifs pour les offres actuelles.

RouteUsageAccèsx402
POST /v1/iban/validateStructure et références pour un IBANEssai sans clé sur cette route, puis clé ou accès payant autorisé0.005 USDC
POST /v1/iban/batchJusqu’à 100 IBAN, résultat par entréeUne unité de quota par IBAN0.002 USDC / IBAN
GET /v1/bic/:codeRecherche d’un BICClé ou accès payant autorisé0.003 USDC
GET /v1/ch/clearing/:iidRéférence de clearing suisseClé ou accès payant autorisé0.003 USDC
POST /v1/iban/complianceIndicateurs concernant l’établissement et le paysClé ou accès payant autorisé ; pas de screening du bénéficiaire0.02 USDC
GET ou POST /v1/iban/formatStructure et somme de contrôle, sans recherche bancaireGratuit, sans clé0
GET ou POST /v1/reference/validateSomme de contrôle des références de paiement prises en chargeGratuit, sans clé0
POST /v1/address/checkFormat d’adresse selon le schéma demandé et ses règles sourcéesGratuit, sans clé0
POST /v1/ch/qr-bill/checkStructure d’une charge utile de QR-facture suisseGratuit, sans clé0
POST /v1/audit/uploadRevue d’un fichier CSV ou ExcelAperçu gratuit ; rapport complet au prix affichéTarif fichier distinct
GET /v1/demoExemples publics de réponseGratuit ; ne teste pas une clé0
GET /healthÉtat public du serviceGratuit0

Packs prépayés : 1 000 crédits = 4 $ ; 5 000 = 20 $ ; 25 000 = 80 $. Les crédits n’expirent pas ; une validation ou une recherche consomme un crédit, un lot en consomme un par IBAN. Le paiement par carte et l’option USDC sont présentés dans les tarifs. L’audit de fichier a son propre tarif selon la taille du fichier, affiché avec l’aperçu gratuit ; il n’est pas compris dans ces prix à l’appel.

Les tarifs et les limites d’accès précisent les offres. Une réponse 402 décrit les options disponibles ; elle ne donne pas à une automatisation l’autorisation d’acheter des crédits ou d’effectuer un paiement.