BIN Lookup API

A free, key-less REST API over a dataset of 374,788 BIN ranges covering 225 countries, 18,373 issuing banks and 71 card brands. Every response is JSON, CORS is enabled, and there is no rate limit for reasonable use.

Single prefix

GET /api/bin/<prefix> — accepts 6 to 11 digits. Longer prefixes are matched on their first six digits.

curl https://darkdollars.ru/api/bin/424242

{
  "bin": "424242",
  "scheme": "VISA",
  "type": "CREDIT",
  "category": "CLASSIC",
  "issuer": "STRIPE PAYMENTS UK, LTD.",
  "country": "GB",
  "matched": "424242",
  "exact": true
}

Bulk lookup

GET /api/bulk?prefixes=424242,555555,378282 — up to 100 prefixes per call, comma or space separated.

curl "https://darkdollars.ru/api/bulk?prefixes=424242,555555"

Query form

GET /api/bin?prefix=424242 — equivalent to the path form.

Statistics

GET /api/stats returns the dataset size, country and issuer counts.

{
  "prefixes": 374788,
  "countries": 225,
  "issuers": 18373,
  "brands": 71
}

Health check

GET /api/health returns {"ok": true, ...} for uptime monitoring.

Response fields

Error handling

A prefix that is not in the dataset returns HTTP 404 with {"error": "prefix not found", "prefix": "..."}. A malformed request returns HTTP 400.

Using the API from JavaScript

const res = await fetch("https://darkdollars.ru/api/bin/" + prefix);
if (res.ok) {
  const card = await res.json();
  console.log(card.scheme, card.issuer, card.country);
}

Data licence and attribution

The underlying BIN list is published under a Creative Commons Attribution 4.0 licence. If you use the API in a product, please credit Dark Dollars BIN data. See the data sources page for full methodology and coverage notes.

Offline access

Prefer not to call the API? The full dataset is published as a CSV and as JSON chunks split by the first three hex digits, so you can load only the range you need.

Frequently asked questions

Related

• Global BIN database
• BIN Lookup tool
• Batch BIN Lookup
• Data sources and methodology