Binlist.net

IMPORTANT INFORMATION

We have stopped updating Binlist.net - transfer now to the paid version of IIN List to stay active. We guarantee a smooth transfer without any downtime if you switch before the sunset date.

Fill out this form if you want to keep using the service

Sunset date: July 15th, 2023, 23:59 CET.


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

API

curl / https

curl -H "Accept-Version: 3" "https://lookup.binlist.net/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 10 per minute with a burst allowance of 10. 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 contact@iinlist.com to get access.

Related projects and resources

About

binlist.net 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.