IBAN Validation API Documentation

V1

/api/v1

First stable version for mathematical IBAN validation requests.

GET /api/v1/iban/validate Auth Required

Validate IBAN

Validates an IBAN mathematically by normalizing the value, converting letters to numbers, and checking that the mod-97 remainder equals 1.

Authentication

X-Api-Key: your_api_key

Query Parameters

Name	Type	Required	Example	Description
`iban`	string	required	`TR320010009999901234567890`	The IBAN value to validate. Spaces are allowed and will be removed before calculation.

Request Example

GET /api/v1/iban/validate?iban=TR320010009999901234567890

Response Example

{
    "success": true,
    "message": "IBAN validated successfully.",
    "data": {
        "input": "TR320010009999901234567890",
        "normalized_iban": "TR320010009999901234567890",
        "country_code": "TR",
        "check_digits": "32",
        "bban": "0010009999901234567890",
        "length": 26,
        "is_valid": true,
        "validation": {
            "has_valid_characters": true,
            "has_valid_length_range": true,
            "has_valid_country_code_format": true,
            "has_valid_check_digits_format": true,
            "checksum_mod97_remainder": 1,
            "passes_checksum": true
        },
        "note": "This endpoint performs mathematical IBAN validation only. It does not confirm that the bank account exists or is active."
    }
}

Error Response

{
    "success": false,
    "message": "The iban field is required.",
    "error_code": "VALIDATION_ERROR"
}