GET
/
lookup
/
bin
BIN/IIN Lookup
curl --request GET \
  --url https://greipapi.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://greip.io/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. One of the most common and critical use cases of this method is to detect and prevent fraud payments in your app or website. This is an essential task for any business that accepts online payments, as fraud can lead to significant financial losses and reputational damage. For example, based on of our case studies, if you notice a user from the UK purchasing large amounts of your product, and the card used for payment is issued by a bank located in the US, this could be a red flag. This may indicate that the user is using a stolen or fraudulent card to complete the checkout process. By flagging such transactions for review or rejection, you can prevent fraud and protect your business from financial loss.

​
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, CSV, or NewlineFor 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.
​
userID
string
The userID command can be used to identify requests sent by specific users to monitor in the Events Page.Expected values: email address, phone number, user id, name, etc.For more information please refer to User Identifier.
​
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://greip.io/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).