Documentation

Documentation et référence API

Comment utiliser ibanworld.de : valider un IBAN, rechercher un BIC, trouver une banque – ainsi que la référence complète de l'API REST.

Valider un IBAN

Vérifiez si un IBAN est structurellement valide et, pour les IBAN allemands, retrouvez la banque correspondante.

Ouvrez le validateur

Rendez-vous sur ibanworld.de — le champ de validation se trouve en haut de la page.

Saisissez ou collez l'IBAN

Les espaces sont supprimés automatiquement, vous pouvez donc coller l'IBAN tel que fourni par votre banque.

Lisez le résultat

Vous verrez si la somme de contrôle (MOD-97, selon ISO 13616) est valide, le pays, l'appartenance SEPA, et pour les IBAN allemands, le nom de la banque, le BIC et la ville.

Rechercher un BIC / code SWIFT

Validez un BIC existant, ou utilisez la recherche par nom de banque sur la même page.

Ouvrez la recherche BIC

Rendez-vous sur ibanworld.de/bic-search.

Validez un BIC

Saisissez un BIC de 8 ou 11 caractères (ex. COBADEFFXXX) pour voir le décodage du code banque, pays, emplacement et succursale.

Trouver une banque par nom

Sur la même page, utilisez le second champ pour rechercher des banques allemandes par nom ou code de tri (Bankleitzahl) — au moins 3 caractères.

Référence pays

La page pays liste les 77 pays pris en charge avec la longueur d'IBAN, le statut SEPA et un exemple d'IBAN testable directement.

API REST — aperçu

La même logique de validation qui alimente le site est disponible sous forme d'API REST JSON. Aucune clé API n'est requise pour l'offre gratuite.

URL de base : https://ibanworld.de/api

Limite (offre gratuite) : 5 requêtes par adresse IP et par jour calendaire (UTC), tous points d'accès /api/* confondus. Chaque réponse inclut les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining et X-RateLimit-Reset. Besoin d'une limite plus élevée ? Contactez-nous.

Format : Toutes les réponses sont en application/json.

POST /api/validate

Valide un IBAN. Accepte aussi GET /api/validate?iban=... pour un test rapide dans un navigateur.

Champ	Type	Requis	Description
iban	string	oui	L'IBAN à valider. Les espaces sont ignorés.

POST/api/validate

curl

curl -X POST https://ibanworld.de/api/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "DE89370400440532013000"}'

response.json

{
  "valid": true,
  "iban": "DE89370400440532013000",
  "formatted": "DE89 3704 0044 0532 0130 00",
  "country": "Germany",
  "country_code": "DE",
  "sepa": true,
  "details": { "blz": "37040044", "account_number": "0532013000" },
  "bank": { "name": "Commerzbank", "bic": "COBADEFFXXX", "city": "Köln" }
}

GET /api/bic/{bic}

Valide un code BIC/SWIFT et retourne la banque correspondante si connue.

GET/api/bic/COBADEFFXXX

response.json

{
  "valid": true,
  "bank_code": "COBA",
  "country_code": "DE",
  "location_code": "FF",
  "branch_code": "XXX",
  "bank": { "name": "Commerzbank", "bic": "COBADEFFXXX", "city": "Köln" }
}

GET /api/banks/search?q=

Recherche des banques allemandes par nom ou code de tri. Minimum 3 caractères ; jusqu'à 20 résultats.

Champ	Type	Requis	Description
q	string	oui	Terme de recherche (nom de banque ou Bankleitzahl), min. 3 caractères.

GET/api/banks/search?q=Commerzbank

response.json

{
  "results": [
    { "name": "Commerzbank", "blz": "37040044", "bic": "COBADEFFXXX", "city": "Köln" }
  ]
}

Erreurs et codes de statut

422missing_iban — le champ iban était vide ou absent.

200valid: false — une requête bien formée mais invalide retourne HTTP 200 avec un champ error expliquant pourquoi.

429rate_limit_exceeded — vous avez utilisé vos 5 requêtes gratuites du jour. Voir X-RateLimit-Reset, ou contactez-nous.