IBAN Structure Validation

Validates IBAN structure and mod-97 checksum locally and extracts French bank/branch/account components when present.

0.002 USD

Charged on valid result · Empty result not charged · Errors not charged

When to use this API?

Use for

Validate an IBAN checksum before using it in a workflow.

Avoid when

Use a more specific endpoint when you only need one already available primitive datum.

Limitations

Results depend on the availability and scope of the cited public sources.

Sources and provenance

ISO 13616 checksum validation

www.iso.org

Input / Output schemas

Simplified endpoint contracts. The complete schema remains available in OpenAPI 3.1.

OpenAPI 3.1 →

Input schema

ibanstring

Required

View full JSON Schema

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

Output schema

ibanstring

Required

country_codestring

Required

structure_validboolean

Required

checksum_validboolean

Required

validboolean

Required

expected_lengthinteger | null

Required

bank_codestring | null

Required

branch_codestring | null

Required

account_numberstring | null

Required

rib_keystring | null

Required

bicstring | null

Required

bank_namestring | null

Required

checked_atstring

Required

limitationsarray

View full JSON Schema

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

Example queries

Validate an IBAN checksum before using it in a workflow.