v4

latestOpenAPI 3.1.02026-08-0117737.6 KB

IBAN

Validate a single IBAN

Validates an IBAN and returns parsed components including country, check digits, BBAN, and optional BIC lookup. Costs 0.005 USDC via x402.

post/v1/iban/validate

Request body

ibanstring required

IBAN to validate (spaces allowed, will be normalized)

Example request

{
  "iban": "GB29NWBK60161331926819"
}

Response

Validation result

ibanstring required

The IBAN as provided (normalized)

validboolean required

check_digitsstring

formattedstring

IBAN formatted in groups of 4

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

error_detailstring

cost_usdcnumber required

processing_msnumber

Example response

{
  "country": {
    "code": "GB",
    "name": "United Kingdom"
  },
  "check_digits": "29",
  "bic": {
    "code": "NWBKGB2L"
  },
  "formatted": "GB29 NWBK 6016 1331 9268 19",
  "clearing": {
    "iid": "00230",
    "name": "UBS Switzerland AG",
    "town": "Zürich"
  },
  "cost_usdc": 0.005
}

All 17 operations