IBAN validation

Validate IBAN format, country, length, MOD-97 checksum and BBAN structure.

This documentation covers API V1.

Endpoint

Validates an IBAN end-to-end: normalization, country support, length, allowed characters, MOD-97 checksum, national structure and BBAN segment parsing.

http

GET https://api.fincode.example.com/v1/iban/validate?iban={iban}

Parameters

Name	Type	In	Description
iban	string	query	The IBAN to validate. Spaces and dashes are stripped; input is uppercased.

Example request

bash

curl -s "https://api.fincode.example.com/v1/iban/validate?iban=DE89 3704 0044 0532 0130 00" \
  -H "Authorization: Bearer sk_test_xxx"

Example response

json

{
  "data": {
    "valid": true,
    "iban": "DE89370400440532013000",
    "country": "DE",
    "check_digits": "89",
    "bank_code": "37040044",
    "account_number": "0532013000",
    "length": 22,
    "expected_length": 22,
    "checks": {
      "charset": true,
      "country": true,
      "length": true,
      "checksum": true,
      "structure": true
    }
  },
  "meta": { "request_id": "req_1a2b3c4d" }
}

Errors

Code	Description
INVALID_IBAN	The IBAN failed format, checksum or structure validation.
IBAN_UNSUPPORTED_COUNTRY	The country does not participate in IBAN.
MISSING_PARAMETER	The iban query parameter is absent.

Notes

A valid IBAN confirms format, length and checksum — it does not confirm that the account exists. FinCode never claims account existence from format validation alone.