binlist.xyz

Enter the 8 digits of a card number (BIN/IIN)

API

curl / https

curl -H "Accept-Version: 3" "https://lookup.binlist.xyz/45717360"

{
  "number": {
    "length": 16,
    "luhn": true
  },
  "scheme": "visa",
  "type": "debit",
  "brand": "Visa/Dankort",
  "prepaid": false,
  "country": {
    "numeric": "208",
    "alpha2": "DK",
    "name": "Denmark",
    "emoji": "🇩🇰",
    "currency": "DKK",
    "latitude": 56,
    "longitude": 10
  },
  "bank": {
    "name": "Jyske Bank",
    "url": "www.jyskebank.dk",
    "phone": "+4589893300",
    "city": "Hjørring"
  }
}

Fields may contain null values which suggests that cards may be one or the other.

If no matching cards are found an HTTP 404 response is returned.

Node.js / npm / browser(ify)

npm install binlookup

var lookup = require('binlookup')()

// callback
lookup('45717360', function( err, data ){
  if (err)
    return console.error(err)

  console.log(data)
})

// promise
lookup('45717360').then(console.log, console.error)

Usage

Limits

Requests are throttled at 5 per hour with a burst allowance of 5. If you hit the speed limit the service will return a 429 http status code.

Need unlimited requests and support for 8-digit BINs?

Get unlimited access from EUR 0.003 per request + a subscription fee. Fill out the form or reach out to us at [email protected] to get access.

Related projects and resources

About

binlist.xyz is a public web service for looking up credit and debit card meta data.

IIN / BIN

The first 6 or 8 digits of a payment card number (credit cards, debit cards, etc.) are known as the Issuer Identification Numbers (IIN), previously known as Bank Identification Number (BIN). These identify the institution that issued the card to the card holder.

Data

The data backing this service is not a table of card number prefixes. That would be unreliable and provide you with too little information. The data is sourced from multiple places, filtered, prioritized, and combined to form the data you eventually see. Some data is formed based on assumptions we make by looking at adjoining cards.

Although this service is very accurate, don't expect it to be perfect.

Dataset downloads, caching and scraping

For the reasons above, we do not provide a static database dump; it is either terribly imprecise or you would need specialized software to compile the results.

Got corrections?

We welcome pull requests on github.com/binlist/data.