Skip to main content
GET
https://api.binuxy.com
/
lookup
/
bin
BIN/IIN Lookup
curl --request GET \
  --url https://api.binuxy.com/lookup/bin \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "reason": "",
    "isValid": true,
    "blacklisted": false,
    "bin": "456789",
    "info": {
      "scheme": {
        "name": "Visa",
        "coName": "Mada",
        "isLuha": true,
        "isPrepaid": false,
        "isCommercial": false,
        "type": "debit",
        "brand": "Traditional",
        "currency": "SAR"
      },
      "detected_digits": "4",
      "syntax": {
        "gaps": [4, 8, 12],
        "lengths": [16, 18, 19],
        "code": {
          "name": "CVV",
          "size": 3
        }
      },
      "bank": {
        "id": "588847",
        "identifier": "80",
        "name": "AL RAJHI BANKING AND INVESTMENT CORP.",
        "city": "Riyadh",
        "url": "https://www.alrajhibank.com.sa",
        "phone": "+96611211600",
        "logo": "https://binuxy.com/img/banks/al-rajhi.jpg",
        "latitude": "25",
        "longitude": "45"
      },
      "country": {
        "alpha2": "SA",
        "name": "Saudi Arabia",
        "code": "966",
        "numeric": "682",
        "emoji": "🇸🇦",
        "continent": "Asia",
        "languageCode": "ar",
        "languageNative": "العربية"
      }
    },
    "custom_rules_applied": {
      "total": 0,
      "rules": []
    }
  },
  "status": "success",
  "executionTime": 2
}

​
Overview

The IIN (Issuer Identification Number), also known as the BIN (Bank Identification Number), is the first 6 digits of a debit or credit card number. These unique numbers are used to identify the issuing entity, such as the bank or financial institution that issued the card. This BIN lookup service is commonly used for payment processing validation, geographic analysis, card type identification, and enhancing checkout experiences. By understanding card details, businesses can optimize their payment flows, provide localized experiences, and make informed decisions about payment processing. For example, you can use this API to identify if a card is issued by a bank in a specific country, determine the card type (debit vs credit), or understand the card brand to customize the user experience accordingly. This information helps in payment routing, currency selection, and providing relevant payment options to users.

​
Query Parameters

​
bin
string
required
The BIN/IIN of the card (min: 6 digits).Sample value: 456789, 456789XXXXXX1234, or 4567891234567890.
​
format
string
default:"JSON"
The format command is used to get a response in a specific format.Expected values: JSON, XML, or CSV.For more information please refer to Response Format.
​
mode
string
default:"live"
The mode command is used to in the development stage to simulate the integration process before releasing it to the production environment.Expected values: live, or test.For more information please refer to Development Environment.
​
callback
string
The callback command can help you make the response as a JSONP format.Expected values: any name that can be used as a function name in Javascript, e.g: myFunctionName.For more information please refer to JSONP Callback.
{
  "data": {
    "reason": "",
    "isValid": true,
    "blacklisted": false,
    "bin": "456789",
    "info": {
      "scheme": {
        "name": "Visa",
        "coName": "Mada",
        "isLuha": true,
        "isPrepaid": false,
        "isCommercial": false,
        "type": "debit",
        "brand": "Traditional",
        "currency": "SAR"
      },
      "detected_digits": "4",
      "syntax": {
        "gaps": [4, 8, 12],
        "lengths": [16, 18, 19],
        "code": {
          "name": "CVV",
          "size": 3
        }
      },
      "bank": {
        "id": "588847",
        "identifier": "80",
        "name": "AL RAJHI BANKING AND INVESTMENT CORP.",
        "city": "Riyadh",
        "url": "https://www.alrajhibank.com.sa",
        "phone": "+96611211600",
        "logo": "https://binuxy.com/img/banks/al-rajhi.jpg",
        "latitude": "25",
        "longitude": "45"
      },
      "country": {
        "alpha2": "SA",
        "name": "Saudi Arabia",
        "code": "966",
        "numeric": "682",
        "emoji": "🇸🇦",
        "continent": "Asia",
        "languageCode": "ar",
        "languageNative": "العربية"
      }
    },
    "custom_rules_applied": {
      "total": 0,
      "rules": []
    }
  },
  "status": "success",
  "executionTime": 2
}

​
Response properties

​
data
object
required
​
status
string
required
Response status (success, or error).
​
executionTime
integer
required
Time taken to process the data (in milliseconds).