Binlist.net

IMPORTANT INFORMATION

***As announced from September 14th 18.00 CET, we are updating the rate limit for Binlist.net. If you wish to continue using the service or get an API key with unlimited lookups, then please send an email to [email protected] or fill out this form.***

You can also signup for our premium service iinlist.com with validated and weekly updated data.

Enter the first 6 to 8 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 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.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.