Sign in

v4

latestOpenAPI 3.1.02026-08-0117737.6 KB
IBAN

Validate up to 100 IBANs in one request

Validates a list of IBANs and returns results for each. Costs $0.002 USDC per IBAN via x402 (e.g. 10 IBANs = $0.020, 100 IBANs = $0.200). On API keys, a batch debits 1 request/credit per IBAN — free tier and prepaid packs alike.

post/v1/iban/batch

Request body

ibansstring[] required

List of IBANs to validate

Example request

{
  "ibans": [
    "GB29NWBK60161331926819",
    "DE89370400440532013000"
  ]
}

Response

Batch validation results

countinteger required

Total IBANs processed

valid_countinteger required

Number of valid IBANs

cost_usdcnumber required

Total cost in USDC

Example response

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