Sign in

v4

latestOpenAPI 3.1.02026-08-0117737.6 KB
Free

Free IBAN format check (mod-97 + structure)

FREE pure-format IBAN check: ISO 13616 mod-97 checksum, country-specific length, and BBAN parsing. No payment, no API key, no quota (global rate limit only). Does NOT touch the BIC, SEPA, VoP, sanctions, or Swiss clearing databases — use POST /v1/iban/validate ($0.005) when you need the full enrichment. Ideal for pre-filtering malformed IBANs before paying for validation.

get/v1/iban/format

Query parameters

ibanstring required
Example:CH1000230000000012345

IBAN to check (spaces allowed, will be normalized)

Response

Format check result. valid=true includes parsed components; valid=false includes error + error_detail. Both include an upgrade_to_full_validation hint.

ibanstring required

The IBAN as provided (normalized)

validboolean required

mod-97 checksum + country structure result

formattedstring

IBAN formatted in groups of 4 (only when valid)

check_digitsstring
error'invalid_format' | 'unsupported_country' | 'wrong_length' | 'checksum_failed'

Only when valid=false

error_detailstring

Only when valid=false

upgrade_to_full_validationstring required

Pointer to POST /v1/iban/validate for BIC, SEPA, VoP, sanctions and Swiss clearing enrichment

Example response

{
  "iban": "CH1000230000000012345",
  "formatted": "CH10 0023 0000 0000 1234 5",
  "country": {
    "code": "CH",
    "name": "Switzerland"
  },
  "check_digits": "10",
  "bban": {
    "bank_code": "00230",
    "account_number": "000000012345"
  }
}