BIN Search Premium API Documentation

√ Your bank information is safe as we do not store or view any data you entered.

Our BIN Search Premium 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 Search 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 Search 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.

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

The API will only return 50 BINS for each search, so please be more specific when searching.

General Request Format

BIN Search 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/bin-search/?format=[FORMAT]&api_key=[API_KEY]&country=[COUNTRY]&
card=[CARD]&bank=[BANK]&type=[TYPE]&level=[LEVEL]&bins=[BINS]

Input Data	Input Type	Explanation
[FORMAT]	Required	Specify the format of the output. Accept "xml" or "json".
[API_KEY]	Required	API Key assign to your account.
[COUNTRY]	Required	Specify the Country in ISO A2 code. Example - DE, GB, US.
[CARD]	Required	Specify the Card Brand. Example - AMERICAN EXPRESS, CHINA UNION PAY, DISCOVER, DINERS CLUB, JCB, MAESTRO, MASTERCARD, VISA
[BANK]	Required	Specify the Bank or Card Issuers. Must be at least 3 characters.
[TYPE]	Optional	Specify the Card Type. Example - CREDIT, DEBIT, CHARGE CARD.
[LEVEL]	Optional	Specify the Card Level. Example - CLASSIC, BUSINESS, STANDARD, PLATINUM, PREPAID, PREMIER, GOLD, ELECTRON, INFINITE, SIGNATURE, WORLD CARD, BLACK, CORPORATE.
[BINS]	Optional	Starting BIN numbers which you would like to search. Example - 4, 41, 414, 4141, 41414

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/bin-search/?format=xml&api_key=9fc53b3db09ca830488d19546a4fc2a1&
country=us&card=visa&bank=abbybank

Expected Result in XML Format

<?xml version="1.0" encoding="utf-8"?>
<root>
  <result>
    <bin>433042</bin>
  </result>
  <result>
    <bin>435255</bin>
  </result>
  <result>
    <bin>447050</bin>
  </result>
  <result_info>
    <total>3</total>
    <display>3</display>
    <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/bin-search/?format=json&api_key=9fc53b3db09ca830488d19546a4fc2a1&
country=us&card=visa&bank=abbybank

Expected Result in JSON Format

{
  "result": [ 
    {"bin":"433042"},
    {"bin":"435255"},
    {"bin":"447050"}
  ],
  "result_info": {
    "total": "3",
    "display": "3",
    "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.