Multi BIN Checker Premium API Documentation

Our Multi BIN Checker API lookup function allows you to automate BIN checker by a simple HTTP GET request. For casual user who is not interested to use API, similar function is available in BIN Checker page.

The function will return the result in either XML or JSON format. You can parse both format easily into various programming languages and platforms.

This page will describe on how to use our BIN Checker API and the expected result you will receive from our systems.

As part of system security and protection, you require to have an API key in order to access our API function, which will be given once you register for API Access.

Multi BIN Checker API is one of our Premium API. To use, users need to have Premium API Credit Balance in their accounts.

For the time being, the API will only check the first 50 BINs from the input list.

Kindly take note that, each API request will utilize the same amount of API Credit as the input BINs. For example, if you make a request to check 10 BINs, then 10 API credits will be deducted.

General Request Format

BIN Checker through our API is very simple. What you need to do is make a GET request. Below is the example on hot to make request.

https://api.bincodes.com/multi-bin/?format=[FORMAT]&api_key=[API_KEY]&bins=[BINS]

1. XML Format Example

If you want to get the result in XML format, simply follow the example API request as below,

https://api.bincodes.com/multi-bin/?format=xml&api_key=9fc53b3db09ca830488d19546a4fc2a1&bins=515735,516735

Expected Result in XML Format

<?xml version="1.0" encoding="utf-8"?>
<root>
  <result>
    <bin>515735</bin>
    <bank>CITIBANK, N.A.</bank>
    <card>MASTERCARD</card>
    <type>CREDIT</type>
    <level>WORLD</level>
    <country>UNITED STATES</country>
    <countrycode>US</countrycode>
    <website>HTTPS://ONLINE.CITIBANK.COM/</website>
    <phone>1-800-374-9700</phone>
  </result>
  <result>
    <bin>516735</bin>
    <bank>PUBLIC JSC VTB BANK</bank>
    <card>MASTERCARD</card>
    <type>DEBIT</type>
    <level>STANDARD</level>
    <country>UKRAINE</country>
    <countrycode>UA</countrycode>
    <website>HTTP://WWW.VTB.COM/</website>
    <phone>(38044) 391-54-09</phone>
  </result>
  <result_info>
    <total>2</total>
    <processed>2</processed>
    <bin_not_found></bin_not_found>
    <bin_omitted></bin_omitted>
    <error></error>
    <message></message>
  </result_info>
</root>

2. JSON Format Example

If you want to get the result in JSON format, simply follow the example API request as below,

https://api.bincodes.com/multi-bin/?format=json&api_key=9fc53b3db09ca830488d19546a4fc2a1&bins=515735,516735

Expected Result in JSON Format

{
  "result": [ 
    {
      "bin":"515735",
      "bank":"CITIBANK, N.A.",
      "card":"MASTERCARD",
      "type":"CREDIT",
      "level":"WORLD",
      "country":"UNITED STATES",
      "countrycode":"US",
      "website":"HTTPS://ONLINE.CITIBANK.COM/",
      "phone":"1-800-374-9700"
    },
    {
      "bin":"516735",
      "bank":"PUBLIC JSC VTB BANK",
      "card":"MASTERCARD",
      "type":"DEBIT",
      "level":"STANDARD",
      "country":"UKRAINE",
      "countrycode":"UA",
      "website":"HTTP://WWW.VTB.COM/",
      "phone":"(38044) 391-54-09"
    }
  ],
  "result_info": {
    "total": "2",
    "processed": "2",
    "bin_not_found": "",
    "bin_omitted": "",
    "error": "",
    "message": ""
  }
}

In some cases, the API may return a response containing error message. Below you can find a description of all possible error messages.