BIN lookup

GET/api/v1/bank/wallet/bin/{card_bin}/Bearer Token

---

Request headers

Header	Value	Required
Authorization	Bearer {A55_ACCESS_TOKEN}	Yes

Path parameters

Field	Type	Required	Description
card_bin	string	Yes	First 6 to 8 digits of the card number (e.g., 402400)

---

Response fields

Field	Type	Description
bin	string	BIN digits queried
brand	string	Card brand: visa, mastercard, amex, elo, hipercard, diners
type	string	credit, debit, prepaid
category	string	classic, gold, platinum, black, infinite, business, corporate
issuer	string	Issuing bank name
country	string	ISO 3166-1 alpha-2 country code
country_name	string	Full country name

---

HTTP status codes

Status	Description
200	BIN found
400	Invalid BIN format (must be 6-8 digits)
401	Invalid or expired Bearer token
404	BIN not found in database
429	Rate limit exceeded
500	Internal server error

---

Code examples

cURL

curl -s -X GET "https://core-manager.a55.tech/api/v1/bank/wallet/bin/402400/" \
  -H "Authorization: Bearer $A55_ACCESS_TOKEN"

Python

import requests
import os

token = os.environ["A55_ACCESS_TOKEN"]
base = os.environ.get("A55_API_URL", "https://core-manager.a55.tech")

card_bin = "402400"

try:
    response = requests.get(
        f"{base}/api/v1/bank/wallet/bin/{card_bin}/",
        headers={"Authorization": f"Bearer {token}"},
    )
    response.raise_for_status()
    info = response.json()
    print(f"Brand: {info['brand']} | Type: {info['type']} | Issuer: {info['issuer']}")
    print(f"Category: {info['category']} | Country: {info['country_name']}")
except requests.exceptions.HTTPError as e:
    print(f"HTTP {e.response.status_code}: {e.response.json()}")
except requests.exceptions.RequestException as e:
    print(f"Request failed: {e}")

Node.js

const token = process.env.A55_ACCESS_TOKEN;
const base = process.env.A55_API_URL || "https://core-manager.a55.tech";

const cardBin = "402400";

try {
  const response = await fetch(`${base}/api/v1/bank/wallet/bin/${cardBin}/`, {
    headers: { Authorization: `Bearer ${token}` },
  });

  if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
  const info = await response.json();
  console.log(`Brand: ${info.brand} | Type: ${info.type} | Issuer: ${info.issuer}`);
  console.log(`Category: ${info.category} | Country: ${info.country_name}`);
} catch (error) {
  console.error("BIN lookup failed:", error.message);
}

---

Error response example

{
  "status": "error",
  "message": [
    {
      "code": "BIN_NOT_FOUND",
      "source": "bin_lookup",
      "description": "No data found for BIN 999999"
    }
  ]
}

---

Tokenize card →Store the card for future charges.Create charge →Charge a card with full details.Zero-auth →Validate a card without charging.