POSTPublicbankcard-bin-international

International BIN Lookup

Identify card scheme (Visa/Mastercard/JCB/AMEX), card type, issuing country and bank from the first 6-8 digits of any international card number.

Documentation

International BIN Lookup

Given the first 6 digits (BIN) of an international credit/debit card, returns:

Card scheme (Visa, Mastercard, JCB, American Express, Discover, ...)
Card type (Credit / Debit / Prepaid)
Issuing country + flag + currency
Issuing bank name / website / phone

Differences vs. `bankcard-info`

bankcard-info covers only mainland China cards
This API covers global card schemes with issuing-country identification

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "bankcard": "4242424242"
}

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "scheme": "Visa",
    "card_type": "Credit",
    "country_name": "United states of america",
    "country_code": "us",
    "country_flag": "🇺🇸",
    "currency": "United States dollar",
    "currency_code": "USD",
    "bank_name": "JPMORGAN CHASE BANK NA"
  }
}

Request Fields

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

Path	Type	Sample
bankcard	string	4242424242

Response Fields

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

Path	Type	Sample
code	number	200
message	string	success
data	object	{...}
data.scheme	string	Visa
data.card_type	string	Credit
data.country_name	string	United states of america
data.country_code	string	us

curl --request POST \ --url 'https://openapi.toolkk.com/v1/bankcard-bin-international' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "bankcard": "4242424242"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/bankcard-bin-international" payload = { "bankcard": "4242424242" } 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())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/bankcard-bin-international" payload := []byte("{\n \"bankcard\": \"4242424242\"\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)) }

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\": \"4242424242\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/bankcard-bin-international")) .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 $endpoint = 'https://openapi.toolkk.com/v1/bankcard-bin-international'; $payload = "{\n \"bankcard\": \"4242424242\"\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;

International BIN Lookup

Documentation