Bank CNAPS Code Lookup API for Chinese Branches

We use cookies.This website uses essential cookies to operate core features. With your consent, we also use analytics cookies to understand traffic and improve the service. For more details, see our .

Bank CNAPS Code Lookup API - China Bank Branch Search | ToolKK

Response Example

{
  "code": "SUCCESS",
  "message": "成功",
  "data": {
    "page": "1",
    "totalpage": "1",
    "totalcount": "1",
    "record": [
      {
        "bankCode": "102584000000",
        "lname": "中国工商银行股份有限公司深圳某支行",
        "bank": "中国工商银行",
        "province": "广东省",
        "city": "深圳市",
        "addr": "深圳市某区",
        "tel": "0755-00000000"
      }
    ]
  }
}

Path	Type	Sample
bank	string	中国工商银行
city	string	深圳市
page	string	1

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	成功
data	object	{...}
data.page	string	1
data.totalpage	string	1
data.totalcount	string	1
data.record	array	{"bankCode":"102584000000","lname":"中国工商银行股份有限公司深圳某支行","bank":"中国工商银行","province":"广东省","city":"深圳市","addr":"深圳市某区","tel":"0755-00000000"}

Shell Example

curl --request POST \
  --url 'https://openapi.toolkk.com/v1/bank-cnaps-code-query' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --data '{\n  "bank": "中国工商银行",\n  "city": "深圳市",\n  "page": "1"\n}'

Python Example

import os
import requests

url = "https://openapi.toolkk.com/v1/bank-cnaps-code-query"
payload = {
  "bank": "中国工商银行",
  "city": "深圳市",
  "page": "1"
}

headers = {
    "Content-Type": "application/json",
    "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"),
}

response = requests.request("POST", url, headers=headers, json=payload, timeout=30)
response.raise_for_status()
print(response.json())

Go Example

package main

import (
    "bytes"
    "fmt"
    "io"
    "net/http"
)

func main() {
    endpoint := "https://openapi.toolkk.com/v1/bank-cnaps-code-query"
    payload := []byte("{\n  \"bank\": \"中国工商银行\",\n  \"city\": \"深圳市\",\n  \"page\": \"1\"\n}")

    req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload))
    if err != nil {
        panic(err)
    }

    req.Header.Set("Content-Type", "application/json")
    req.Header.Set("X-API-Key", "YOUR_API_KEY")

    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, err := io.ReadAll(resp.Body)
    if err != nil {
        panic(err)
    }

    fmt.Println(string(body))
}

Java Example

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ToolkkExample {
    public static void main(String[] args) throws Exception {
        String payload = "{\n  \"bank\": \"中国工商银行\",\n  \"city\": \"深圳市\",\n  \"page\": \"1\"\n}";

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://openapi.toolkk.com/v1/bank-cnaps-code-query"))
            .method("POST", HttpRequest.BodyPublishers.ofString(payload))
            .header("Content-Type", "application/json")
            .header("X-API-Key", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

PHP Example

<?php

$endpoint = 'https://openapi.toolkk.com/v1/bank-cnaps-code-query';
$payload = "{\n  \"bank\": \"中国工商银行\",\n  \"city\": \"深圳市\",\n  \"page\": \"1\"\n}";

$ch = curl_init($endpoint);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'X-API-Key: YOUR_API_KEY',
    ],
    CURLOPT_POSTFIELDS => $payload,
]);

$response = curl_exec($ch);
if ($response === false) {
    throw new RuntimeException(curl_error($ch));
}

curl_close($ch);
echo $response;

Bank CNAPS Code Lookup

Documentation

Overview

Integration Examples

Request Example