Documentation de l’API de validation d’IBAN

L’API REST d’IBAN-Test vérifie la structure et la clé des IBAN, renvoie les données bancaires et BIC disponibles, contrôle les BIC et les comptes bancaires allemands et génère des IBAN à partir de coordonnées bancaires. Utilisez le jeton API de votre tableau de bord pour vous authentifier et intégrez les réponses JSON à vos formulaires, traitements de paiement et systèmes internes.

Essayer le vérificateur d’IBAN en ligne · Utiliser le générateur d’IBAN · Connecter le serveur MCP

Authentification

Utilisez le jeton de la rubrique API overview comme jeton Bearer dans l’en-tête HTTP :

Authorization: Bearer YOUR_API_TOKEN

Après connexion, retrouvez votre jeton dans API overview. Vous n’avez pas encore de compte ? Créez votre clé API.

URL de base

https://www.iban-test.eu/api

Points d’accès

• GET /v2/iban/validate?iban=... – vérifier un IBAN
• GET /v2/iban/validate/{iban} – vérifier un IBAN transmis dans le chemin de l’URL
• POST /v2/iban/validate – vérifier un IBAN transmis dans le corps de la requête
• GET /v2/bic/validate/{bic} – vérifier un BIC
• GET /v2/bank-account/validate?bankcode=...&accountnumber=... – vérifier un compte bancaire allemand
• GET /v2/iban/generate?countrycode=...&bankcode=...&accountnumber=... – générer un IBAN

Les contrôles effectués sur un IBAN

• Code pays, caractères et longueur du format IBAN national
• Clé de contrôle IBAN vérifiée par le calcul international MOD-97
• Données disponibles dans les référentiels : nom de la banque, ville et BIC

Un résultat valide confirme la cohérence formelle de l’IBAN. Il ne prouve pas que le compte existe, appartient à une personne donnée, est actif ou peut recevoir des paiements.

Exemples de requêtes

Vérifier un IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/validate?iban=DE89%203704%200044%200532%200130%2000"

Les espaces sont acceptés dans les IBAN et supprimés automatiquement avant la vérification.

Vérifier un BIC

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bic/validate/COBADEFFXXX"

Vérifier un compte bancaire

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/bank-account/validate?bankcode=37040044&accountnumber=532013000"

Générer un IBAN

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  "https://www.iban-test.eu/api/v2/iban/generate?countrycode=DE&bankcode=37040044&accountnumber=532013000"

Format des réponses et gestion des erreurs

Tous les points d’accès renvoient du JSON. Avant d’accepter ou d’enregistrer des coordonnées bancaires, examinez la réponse HTTP et les champs error, code, message ainsi que le champ facultatif details .

{
  "error": false,
  "code": 2100,
  "message": "IBAN is valid",
  "details": {}
}

Consultez OpenAPI pour les schémas actuels des paramètres et des réponses. Une clé IBAN correcte ne confirme pas l’identité du titulaire du compte.

{
  "details": {
    "sepa": {
      "sddCore": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sddB2b": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sct": {
        "status": "confirmed",
        "reason": "matched"
      },
      "sctInst": {
        "status": "confirmed",
        "reason": "matched"
      }
    }
  }
}

MCP pour les clients IA

En complément de l’API REST, IBAN-Test propose un serveur Model Context Protocol pour la vérification d’IBAN. MCP expose les mêmes fonctions bancaires sous forme d’outils structurés pour les clients et agents IA compatibles.

https://www.iban-test.eu/mcp

Authorization: Bearer YOUR_API_TOKEN

Outils MCP disponibles

• validate_iban – vérifie un IBAN
• validate_iban_batch – vérifie plusieurs IBAN ; chaque IBAN compte comme une requête API
• generate_test_iban – génère un IBAN à partir du pays, du code bancaire et du numéro de compte
• ibantest_bank_account_validate – vérifie un code bancaire et un numéro de compte allemands
• ibantest_bic_validate – vérifie un BIC et renvoie les coordonnées bancaires disponibles
• get_usage_info – Affiche l’utilisation de l’API sans consommer de requête de validation.

Les appels fonctionnels aux outils MCP sont décomptés de votre quota API IBAN-Test, comme les requêtes REST.

Remarques

• L’API REST et MCP utilisent des jetons Bearer.
• L’ancienne API utilisant un code d’authentification n’est pas décrite dans cette documentation.
• Les requêtes fonctionnelles sont décomptées du quota API en cours.