MedoList.net

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

API

curl / https

curl -H "Accept-Version: 3" "https://lookup.MedoList.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 2 per second with a burst allowance of 10. If you hit the speed limit the service will return a 429 http status code.

Need more? Get unlimited access at $ 0.001/request by reaching out to MedoList@src.agency.

Uptime

See our status page (third party operated) for live uptime stats.

Updates

For important updates on the API please subscribe here.

Related projects and resources

About

MedoList.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/MedoList/data.