---
title: "Lookup a BIC/SWIFT code"
method: GET
path: "/v1/bic/{code}"
tags: ["BIC"]
---

# Lookup a BIC/SWIFT code

`GET /v1/bic/{code}`

Returns institution details for a BIC/SWIFT code (8 or 11 characters). Costs 0.003 USDC via x402.

## Path parameters

- `code` string, required

## Response `200`

BIC lookup result

- BICLookupResult
  - `bic` string, required
  - `bic8` string, required
  - `bic11` string, required
  - `found` boolean, required
  - `valid_format` boolean, required
  - `institution` string, nullable, required
  - `country` object, required
    - `code` string, required
    - `name` string, required
  - `city` string, nullable, required
  - `address` object — Registered head-office address (present when available — GLEIF or directory sourced)
    - `type` string
    - `street` string, nullable
    - `post_code` string, nullable
    - `region` string, nullable
    - `city` string, nullable
    - `country` string
    - `romanized` string, nullable
    - `romanization` string
    - `source` string
    - `language` string
    - `as_of` string, date
  - `address_available` boolean
  - `branch_code` string, required
  - `branch_info` string, nullable, required
  - `lei` string, nullable, required
  - `lei_status` string, nullable, required
  - `is_test_bic` boolean, required
  - `source` string, nullable, required
  - `note` string
  - `cost_usdc` number, required
  - `processing_ms` number

## Other responses

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

---

[API](https://skmtc.net/ibanforge/apis/ibanforge-api.md) · [All operations](https://skmtc.net/ibanforge/apis/ibanforge-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ibanforge/ibanforge-api/versions/1d9e9674b3d2/schema)