China CNAPS code lookup

Resolve a 12-digit CNAPS bank identification number.

This documentation covers API V1.

Endpoint

Returns the Chinese institution behind a 12-digit CNAPS code (联行号) used in the national payment system.

http

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

Parameters

Name	Type	In	Description
code	string	path	The 12-digit CNAPS code, e.g. 102100099996.

Example request

bash

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

Example response

json

{
  "data": {
    "cnaps": "102100099996",
    "bank_code": "102",
    "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"
    },
    "branch": "Head Office (北京)",
    "city": "Beijing",
    "status": "ACTIVE",
    "source": {
      "name": "PBOC CNAPS participant list",
      "source_type": "OFFICIAL",
      "retrieved_at": "2026-09-01"
    }
  },
  "meta": { "request_id": "req_8d3a06e9" }
}

Errors

Code	Description
INVALID_CNAPS	The code is not 12 digits.
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.