BIN Checker BIN Search IP/BIN Checker Credit Card Checker Credit Card Generator

BIN Checker API Documentation


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

Our 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.


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/bin/?format=[FORMAT]&api_key=[API_KEY]&bin=[BIN]

OR
https://api.bincodes.com/bin/[FORMAT]/[API_KEY]/[BIN]/

Input DataExplanation
[FORMAT]Specify the format of the output. Accept "xml" or "json".
[API_KEY]API Key assign to your account.
[BIN]BIN which you would like to check.


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/?format=xml&api_key=9fc53b3db09ca830488d19546a4fc2a1&bin=515735

OR
https://api.bincodes.com/bin/xml/9fc53b3db09ca830488d19546a4fc2a1/515735/

Expected Result in XML Format


<?xml version="1.0" encoding="utf-8" ?>
<result>
  <bin>515735</bin>
  <bank>CITIBANK, N.A.</bank>
  <card>MASTERCARD</card>
  <type>CREDIT</type>
  <level>WORLD CARD</level>
  <country>UNITED STATES</country>
  <countrycode>US</countrycode>
  <website>HTTPS://ONLINE.CITIBANK.COM/</website>
  <phone>1-800-374-9700</phone>
  <valid>true</valid>
</result>


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/?format=json&api_key=9fc53b3db09ca830488d19546a4fc2a1&bin=515735

OR
https://api.bincodes.com/bin/json/9fc53b3db09ca830488d19546a4fc2a1/515735/

Expected Result in JSON Format


{
    "bin": "515735",
    "bank": "CITIBANK, N.A.",
    "card": "MASTERCARD",
    "type": "CREDIT",
    "level": "WORLD CARD",
    "country": "UNITED STATES",
    "countrycode": "US",
    "website": "HTTPS://ONLINE.CITIBANK.COM/",
    "phone": "1-800-374-9700",
    "valid": "true"
}


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

Error IDError MessageExplanation
1001API Key Not SpecifiedYou need to specify your API Key while making API request. Kindly check the API Key in user area.
1002Invalid API KeyPlease make sure that you specify the correct API Key assign to your account. Kindly check the correct API Key in the user area.
1003Suspended API KeyYour API Key was suspended due to system abuse. Kindly contact support.
1004API Usage Limit ExceededYou have exceeded the daily limit allocated to your account. You may purchase additional credit in the user area.
1005Zero Premium API CreditYou need to have Premium API Credits in order to use Premium API functions. You may purchase credit in the user area.
1006Insufficient API CreditYou need to have sufficient Premium API Credits in order to use Multiple Lookup API. You may purchase additional credit in the user area.
1007IP Address Not AllowedYou enable IP Address whitelist but your current IP address is not in the list. You need to whitelist your IP adreess in the user area.
1010BIN Not SpecifiedYou need to specify BIN you want to check.
1011Invalid BINPlease make sure that you specify BIN in the correct format which is 6 digits long.
1012BIN Not FoundThe BIN that you submitted is not found in our database.
1013Credit Card or Debit Card Number Not SpecifiedYou need to specify Credit Card or Debit Card Number you want to check.
1014Invalid Credit Card or Debit Card NumberPlease make sure that you specify the correct Credit Card or Debit Card Number.
1015Invalid Credit Card or Debit Card Number LengthPlease make sure that the Credit Card or Debit Card Number has the correct length.
1016Invalid ChecksumThe Credit Card or Debit Card Number is invalid as it contains the wrong checksum.
1017Unsupported BIN to GenerateThe BIN that you submitted is not supported to generate credit card numbers.
1018Unsupported Input Data to GenerateThe Input Data that you submitted is not supported to generate credit card numbers.
1019Country or Card or Bank Input ErrorTo search through API, please ensure you enter the correct country code, card brand and at least contain 3 characters of for Bank input.
1020BINS Input ErrorOnly numbers with length between 1 to 6 digits allowed.
1021Zero BIN FoundSearch yield zero result.