---
title: "Swiss BC-Nummer / IID clearing lookup"
method: GET
path: "/v1/ch/clearing/{iid}"
tags: ["Swiss Clearing"]
---

# Swiss BC-Nummer / IID clearing lookup

`GET /v1/ch/clearing/{iid}`

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.

## Path parameters

- `iid` string, required

## Response `200`

Clearing lookup result

- ChClearingResult
  - `iid` string, required — Zero-padded 5-digit IID
  - `found` boolean, required
  - `institution` object
    - `name` string
    - `type` 'bank' | 'cantonal_bank' | 'postfinance' | 'raiffeisen' | 'central_bank' | 'foreign_participant'
    - `iid_type` 'headquarters' | 'branch' | 'other'
    - `headquarters_iid` string, nullable
  - `address` object
    - `street` string, nullable
    - `building_number` string, nullable
    - `post_code` string, nullable
    - `town` string, nullable
    - `country` string
  - `bic` string, nullable
  - `payment_services` object
    - `sic` boolean — SIC (Swiss Interbank Clearing) participation
    - `rtgs_chf` boolean — Real-Time Gross Settlement CHF
    - `instant_payments_chf` boolean — Instant Payments CHF
    - `eurosic` boolean — euroSIC participation
    - `lsv_bdd_chf` boolean — LSV/BDD CHF direct debit
    - `lsv_bdd_eur` boolean — LSV/BDD EUR direct debit
  - `sic_iid` string, nullable
  - `qr_iid` string, nullable — QR-IID for QR-bill payments
  - `valid_on` string, date
  - `cost_usdc` number
  - `processing_ms` number

## Other responses

- `400` — Invalid IID format
- `402` — Payment required (x402)

---

[API](https://skmtc.dev/ibanforge/apis/ibanforge-api.md) · [All operations](https://skmtc.dev/ibanforge/apis/ibanforge-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ibanforge/ibanforge-api/revisions/9499dba434ea/schema)