v4

latestOpenAPI 3.1.02026-08-0117737.6 KB

Swiss Clearing

Swiss BC-Nummer / IID clearing lookup

Returns institution details, payment service participation (SIC, euroSIC, Instant Payments CHF), and QR-IID allocation for a Swiss BC-Nummer (IID). Costs 0.003 USDC via x402.

get/v1/ch/clearing/{iid}

Path parameters

iidstring required

Example:230

Swiss BC-Nummer / IID (1-5 digits, zero-padded to 5)

Response

Clearing lookup result

iidstring required

Zero-padded 5-digit IID

foundboolean required

bicstring nullable

sic_iidstring nullable

qr_iidstring nullable

QR-IID for QR-bill payments

valid_onstring date

cost_usdcnumber

processing_msnumber

Example response

{
  "iid": "00230",
  "institution": {
    "name": "UBS Switzerland AG"
  },
  "address": {
    "country": "CH"
  },
  "bic": "UBSWCHZH80A",
  "cost_usdc": 0.003
}