API Documentation

The BINLookup REST API lets you integrate BIN data directly into your payment systems. Available on the Enterprise plan.

Authentication

Pass your API key as a Bearer token in the Authorization header.

Authorization: Bearer YOUR_API_KEY

BIN Lookup

GET/api/v1/lookup?bin={bin}

Returns card details for the given BIN. Accepts 6 or 8 digits.

Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://yourdomain.com/api/v1/lookup?bin=405782"

Response

{
  "bin": "405782",
  "brand": "VISA",
  "card_type": "CREDIT",
  "card_category": "CLASSIC",
  "issuer": "(PKO BANK POLSKI)",
  "bank_name": "POWSZECHNA KASA OSZCZEDNOSCI BANK POLSKI SA",
  "country": {
    "code": "PL",
    "name": "Poland",
    "flag": "🇵🇱"
  }
}

Response Fields

Field	Type	Description
bin	string	The matched BIN (6 digits)
brand	string	Card network: VISA, MASTERCARD, MAESTRO, etc.
card_type	string	CREDIT, DEBIT, or CHARGE CARD
card_category	string	CLASSIC, GOLD, PLATINUM, BUSINESS, PREPAID, etc.
issuer	string	Short issuer name
bank_name	string	Full issuing bank name
country.code	string	ISO 3166-1 alpha-2 country code
country.name	string	Full country name
country.flag	string	Country flag emoji

Error Codes

Status	Meaning
200	Success
400	Invalid BIN format (too short, non-numeric)
401	Missing or invalid API key
404	BIN not found in database
429	Rate limit exceeded (free tier: 5/day)

API access requires the Enterprise plan

$99.95/month · Unlimited requests · Full JSON responses

Get Enterprise →