bankcard-info
Bank Card Location Lookup
Look up bank card numbers to identify the issuing bank, card type, and geographic location. Supports recognition of major bank cards.
Usage Cost
5 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/bankcard-infocURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/bankcard-info' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "bankcard": "6228480402564890018"\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/bankcard-info"
payload = {
"bankcard": "6228480402564890018"
}
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/bankcard-info"
payload := []byte("{\n \"bankcard\": \"6228480402564890018\"\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 \"bankcard\": \"6228480402564890018\"\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/bankcard-info"))
.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/bankcard-info';
$payload = "{\n \"bankcard\": \"6228480402564890018\"\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;Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"bank": "中国农业银行",
"cardType": "借记卡",
"cardName": "金穗通宝卡"
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| bankcard | string | Unspecified | Unspecified | 6228480402564890018 |
Request Example
{
"bankcard": "6228480402564890018"
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| code | string | Unspecified | Unspecified | SUCCESS |
| message | string | Unspecified | Unspecified | success |
| data | object | Unspecified | Unspecified | {...} |
| data.bank | string | Unspecified | Unspecified | 中国农业银行 |
| data.cardType | string | Unspecified | Unspecified | 借记卡 |
| data.cardName | string | Unspecified | Unspecified | 金穗通宝卡 |
Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"bank": "中国农业银行",
"cardType": "借记卡",
"cardName": "金穗通宝卡"
}
}$.code == 200 API overview
Capabilities, use cases, limitations, and frequently asked questions.
Features: This API provides a convenient bank card location lookup service. Users simply enter a bank card number to quickly retrieve detailed information, including the issuing bank's name, card type (e.g., debit or credit card), and the issuer's geographic location. The interface supports the recognition of debit and credit cards from major domestic banks, offering high data accuracy and fast response times. It is an ideal choice for finance, payment, and risk control scenarios.
Use Cases:
- Financial Risk Control: Verify the authenticity and consistency of bank card information during payments, transfers, and other transactions to effectively reduce transaction risks.
- User Experience Optimization: Automatically autofill the bank name when users input their bank card number, reducing manual entry and improving operational convenience.
- Marketing & Promotion: Conduct targeted regional marketing campaigns based on the user's bank card location to improve conversion rates.
- Data Analysis: Assist in user persona analysis and regional financial data statistics to provide data-driven support for decision-making.