Sign in
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",
        "lei": "851WYGNLUQLFZBSYGB56",
        "lei_status": "ACTIVE",
        "address": {
          "street": "Kaiserstraße 16",
          "post_code": "60311",
          "region": "DE-HE",
          "city": "Frankfurt am Main",
          "country": "DE",
          "source": "GLEIF",
          "language": "de",
          "as_of": "2026-02-24"
        }
      },
      "formatted": "GB29 NWBK 6016 1331 9268 19",
      "clearing": {
        "iid": "00230",
        "name": "UBS Switzerland AG",
        "town": "Zürich"
      },
      "reference_check": {
        "reference": "210000000003139471430009017",
        "as_of": "2026-02",
        "pairing_as_of": "2026-02"
      },
      "cost_usdc": 0.005,
      "official_identity": {
        "name": "Alpha Bank Example, S.A.",
        "category": "Credit Institution",
        "source": "European Central Bank, list of monetary financial institutions (free at ecb.europa.eu)",
        "attribution": "Own elaboration based on data from the Banco de España website (www.bde.es)"
      },
      "modulus_check": {
        "source": "Vocalink modulus weight table (published for Pay.UK)",
        "table_fetched_on": "2026-08-14"
      }
    }
  ]
}

Changes