Validation structure IBAN

Valide localement la structure et la clé mod-97 d’un IBAN et extrait les composants banque/guichet/compte français lorsqu’ils existent.

0.002 USD

Facturation sur résultat valide · Résultat vide non facturé · Erreur non facturée

Quand utiliser cette API ?

À utiliser pour

Valider la clé d’un IBAN avant de l’utiliser dans un workflow.

À éviter quand

Utilisez une API plus spécialisée si vous n’avez besoin que d’une donnée élémentaire déjà disponible.

Limitations

Les résultats dépendent de la disponibilité et du périmètre des sources publiques citées.

Sources et provenance

ISO 13616 checksum validation

www.iso.org

Schémas Input / Output

Contrats simplifiés de l’endpoint. Le schéma complet reste disponible dans OpenAPI 3.1.

OpenAPI 3.1 →

Input schema

ibanstring

Obligatoire

Voir le JSON Schema complet

{
    "type": "object",
    "properties": {
        "iban": {
            "type": "string",
            "minLength": 15,
            "maxLength": 34
        }
    },
    "additionalProperties": false,
    "required": [
        "iban"
    ]
}

Output schema

ibanstring

Obligatoire

country_codestring

Obligatoire

structure_validboolean

Obligatoire

checksum_validboolean

Obligatoire

validboolean

Obligatoire

expected_lengthinteger | null

Obligatoire

bank_codestring | null

Obligatoire

branch_codestring | null

Obligatoire

account_numberstring | null

Obligatoire

rib_keystring | null

Obligatoire

bicstring | null

Obligatoire

bank_namestring | null

Obligatoire

checked_atstring

Obligatoire

limitationsarray

Voir le JSON Schema complet

{
    "type": "object",
    "properties": {
        "iban": {
            "type": "string"
        },
        "country_code": {
            "type": "string"
        },
        "structure_valid": {
            "type": "boolean"
        },
        "checksum_valid": {
            "type": "boolean"
        },
        "valid": {
            "type": "boolean"
        },
        "expected_length": {
            "type": [
                "integer",
                "null"
            ]
        },
        "bank_code": {
            "type": [
                "string",
                "null"
            ]
        },
        "branch_code": {
            "type": [
                "string",
                "null"
            ]
        },
        "account_number": {
            "type": [
                "string",
                "null"
            ]
        },
        "rib_key": {
            "type": [
                "string",
                "null"
            ]
        },
        "bic": {
            "type": [
                "string",
                "null"
            ]
        },
        "bank_name": {
            "type": [
                "string",
                "null"
            ]
        },
        "checked_at": {
            "type": "string"
        },
        "limitations": {
            "type": "array",
            "items": {
                "type": "string"
            }
        }
    },
    "additionalProperties": false,
    "required": [
        "iban",
        "country_code",
        "structure_valid",
        "checksum_valid",
        "valid",
        "expected_length",
        "bank_code",
        "branch_code",
        "account_number",
        "rib_key",
        "bic",
        "bank_name",
        "checked_at"
    ]
}

Exemples de requêtes

Valider la clé d’un IBAN avant de l’utiliser dans un workflow.