SWIFT / BIC lookup

Resolve a SWIFT/BIC code (ISO 9362) to its institution, country, city and branch.

This documentation covers API V1.

Endpoint

Returns the institution behind an 8 or 11 character SWIFT/BIC code, including the head-office location and related identifiers.

http

GET https://api.fincode.example.com/v1/swift/{code}

Parameters

Name	Type	In	Description
code	string	path	The SWIFT/BIC code, e.g. ICBKCNBJ. Case-insensitive.

Example request

bash

curl -s "https://api.fincode.example.com/v1/swift/ICBKCNBJ" \
  -H "Authorization: Bearer sk_test_xxx"

Example response

json

{
  "data": {
    "swift_code": "ICBKCNBJ",
    "bic": "ICBKCNBJ",
    "format": {
      "institution_code": "ICBK",
      "country_code": "CN",
      "location_code": "BJ",
      "branch_code": null
    },
    "bank": {
      "id": "inst_icbc",
      "name_en": "Industrial and Commercial Bank of China",
      "name_local": "中国工商银行股份有限公司",
      "short_name": "ICBC",
      "country": "CN",
      "website": "https://www.icbc.com.cn"
    },
    "city": "Beijing",
    "status": "ACTIVE",
    "source": {
      "name": "SWIFT/BIC directory",
      "source_type": "PUBLIC",
      "retrieved_at": "2026-09-01"
    }
  },
  "meta": { "request_id": "req_9f2c81a4" }
}

Errors

Code	Description
INVALID_SWIFT	The code is not a valid 8 or 11 character BIC.
NOT_FOUND	The identifier does not exist in the dataset.
UNAUTHORIZED	Missing or invalid API key.
RATE_LIMITED	Rate limit exceeded — retry after the indicated delay.