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 besoin | Point de départ |
|---|---|
| Ajouter un contrôle à un logiciel de comptabilité ou d’ERP | Premier appel et lecture du résultat |
| Reprendre un fichier fournisseurs avant migration | Revue de fichier avec propositions séparées |
| Contrôler un IBAN après extraction OCR | Usages, limites et cas à revoir |
| Automatiser sans développer un client complet | Recettes Python, SDK, Sheets et n8n |
| Fournir des outils à un agent | MCP 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.
validetchecks: format, somme de contrôle et contrôles effectivement réalisés.not_checkedn’est paspass.bank_code_checketbic: 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.
| Route | Usage | Accès | x402 |
|---|---|---|---|
POST /v1/iban/validate | Structure et références pour un IBAN | Essai sans clé sur cette route, puis clé ou accès payant autorisé | 0.005 USDC |
POST /v1/iban/batch | Jusqu’à 100 IBAN, résultat par entrée | Une unité de quota par IBAN | 0.002 USDC / IBAN |
GET /v1/bic/:code | Recherche d’un BIC | Clé ou accès payant autorisé | 0.003 USDC |
GET /v1/ch/clearing/:iid | Référence de clearing suisse | Clé ou accès payant autorisé | 0.003 USDC |
POST /v1/iban/compliance | Indicateurs concernant l’établissement et le pays | Clé ou accès payant autorisé ; pas de screening du bénéficiaire | 0.02 USDC |
GET ou POST /v1/iban/format | Structure et somme de contrôle, sans recherche bancaire | Gratuit, sans clé | 0 |
GET ou POST /v1/reference/validate | Somme de contrôle des références de paiement prises en charge | Gratuit, sans clé | 0 |
POST /v1/address/check | Format d’adresse selon le schéma demandé et ses règles sourcées | Gratuit, sans clé | 0 |
POST /v1/ch/qr-bill/check | Structure d’une charge utile de QR-facture suisse | Gratuit, sans clé | 0 |
POST /v1/audit/upload | Revue d’un fichier CSV ou Excel | Aperçu gratuit ; rapport complet au prix affiché | Tarif fichier distinct |
GET /v1/demo | Exemples publics de réponse | Gratuit ; ne teste pas une clé | 0 |
GET /health | État public du service | Gratuit | 0 |
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.