BIN Lookup

Look up card issuer information for a 6–8 digit BIN. Requires an API key passed as a request header.

Request headers

Header	Description
X-Api-Key required	Your API key

Path parameter

Name	Description
number	6–8 digit bank identification number

Response headers

Header	Value
X-Bin-Source	cache · db · or external source name
X-RateLimit-Limit	Request cap for your key tier
X-RateLimit-Remaining	Requests left in the current window
X-RateLimit-Reset	Unix timestamp when the window resets

200 — success

{
  "bin":          "411111",
  "brand":        "VISA",
  "bank_name":    "Chase",
  "bank_phone":   "+1-800-935-9935",
  "bank_url":     "chase.com",
  "country_code": "US",
  "country_name": "United States",
  "latitude":     37.09024,
  "longitude":    -95.712891,
  "card_type":    "CREDIT",
  "card_category":"CLASSIC",
  "prepaid":      false,
  "source":       "binlist",
  "created_at":   "2026-04-10T15:39:47.661124Z",
  "updated_at":   "2026-04-10T15:39:47.661124Z"
}

Error body

{ "error": "not_found", "message": "BIN 000000 could not be resolved from any source" }

Status	Meaning
200	BIN found
400	Invalid BIN format
401	Missing or invalid API key
404	BIN not found in any source
429	Rate limit exceeded

Returns the operational status of the API, database, and cache. No authentication required.

200 / 503

{ "status": "ok", "db": true, "redis": true }

Returns the build version, git commit SHA, and build timestamp of the running binary. No authentication required.

200

{ "version": "main", "commit": "a3f9c12d", "built_at": "2026-04-10T12:00:00Z" }