{"uid":"cap_2HSQX8qUaU9Mf6BW2nQpX","slug":"ibanforge-swiss-clearing-number-iid-lookup-c401645d","name":"IBANForge Swiss Clearing Number (IID) Lookup","description":"Resolve a Swiss BC-Nummer / IID (1-5 digits) into institution name, type, address, BIC, the full payment-rail participation (SIC, RTGS CHF, Instant Payments CHF, euroSIC, LSV+/BDD) and the QR-IID allocation. Backed by 1,100+ SIX BankMaster entries (refreshed monthly) — the canonical Swiss banking source. Production · server processing <5ms (network excluded — measure your own round trip on GET /ping) · 1,100+ SIX BankMaster entries, refreshed monthly · v1.4.3.","url":"https://api.ibanforge.com/v1/ch/clearing/:iid?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"discoverable":{"type":"boolean"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_RFSW76wyhpMuLqjyXrg4Q","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a Swiss BC-Nummer / IID (1–5 digits) into full institution details including name, type, address, BIC, and payment-rail participation (SIC, RTGS CHF, Instant Payments CHF, euroSIC, LSV+/BDD) from the SIX BankMaster registry.","exampleAgentPrompt":"Can you look up Swiss clearing number 768 and tell me the bank's full name, its BIC, and whether it's enrolled in Instant Payments CHF and QR-IID?","exampleUseCases":[{"title":"Verify Swiss payee bank before wire","prompt":"I'm about to send a CHF payment and I have the beneficiary's BC-Nummer 8390 — can you resolve it to the bank name, address, and BIC, and confirm it participates in SIC so the transfer will go through?"},{"title":"QR-bill payment rail validation","prompt":"We're building a QR-bill payment flow and need to check whether the bank with IID 245 has a QR-IID allocation and supports Instant Payments CHF."},{"title":"Swiss bank directory enrichment","prompt":"I have a list of Swiss clearing numbers starting with IID 4835 — look that one up and give me the full institution details including type, city, and all payment rail memberships so I can enrich our internal bank directory."}],"resultDescription":"Returns the institution's official name, institution type, full postal address, BIC/SWIFT code, participation flags for SIC, RTGS CHF, Instant Payments CHF, euroSIC, and LSV+/BDD payment rails, plus QR-IID allocation status — sourced from 1,100+ SIX BankMaster entries refreshed monthly.","failureModes":["IID not found (no matching entry in SIX BankMaster) — returns 404","IID out of valid range (must be 1–5 digits) — returns 400 validation error","Upstream SIX BankMaster data temporarily unavailable — returns 503","Network timeout (server processing <5ms but round-trip latency varies — use GET /ping to measure)","Payment rejected before call (x402 payment protocol failure)"],"whenToPreferThis":"Use this endpoint when you have a Swiss BC-Nummer or IID and need authoritative institution details and payment-rail membership from the canonical SIX BankMaster source. Prefer this over generic IBAN validation when you specifically need Swiss interbank clearing data, QR-IID allocation, or CHF-specific rail participation (SIC, RTGS CHF, Instant Payments CHF). For European IBANs or BIC-first lookups, use the sibling IBAN validation or BIC resolution endpoints instead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:36:00.646Z","isFirstParty":false,"canonicalSlug":"ibanforge-swiss-clearing-number-iid-lookup-c401645d"}