Overview

A BIN lookup is the process of retrieving a card's metadata by providing a primary account number (PAN). You can use this data to help identify suspicious transactions and assess potential risks.

You can perform two types of lookup:

Basic, which provides high-level data about the card.
Extended, which provides more detailed information about a card, such as 3D Secure data, regulatory value, and cashback eligibility.

For both types of lookup, you'll need to provide a primaryAccountNumber, which should be a valid card number format.

Basic lookup

POST

/v1/bin-recognition/bin-range-lookup

Request example

Use the following request to perform a basic BIN lookup.

{
  "primaryAccountNumber": "5266001055000075"
}

Parameter	Description
`primaryAccountNumber` string required	The unique number assigned to a payment card, such as a credit or debit card. This number typically contains 16 digits, structured in a specific format to indicate the card network, issuing bank, and account number.

Response example

If your request is successful, you'll receive a 200 response.

{  
  "fromBin": 526600000000000000,
  "toBin": 526699999999999999,
  "cardScheme": "MasterCard",
  "issuerName": "Bank of America",
  "issuerCountryCode": "USA",
  "issuerMemberId": "560478",
  "cardType": "MasterCard",
  "fundingSource": "Credit",
  "ownerType":"Consumer",
  "currencyCode": "USD",
  "binLength": 6,
  "gamingCreditSupported": true,
  "productName": "Consumer",
  "productTarget": "USA",
  "isAnonymousProduct": true,
  "rangeType":"W"
}

Extended lookup

POST

/v1/bin-recognition/bin-range-lookup/extended

Request example

Use the following request to perform an extended BIN lookup.

{
  "primaryAccountNumber": "5266001055000075"
}

Parameter	Description
`primaryAccountNumber` string required	The unique number assigned to a payment card, such as a credit or debit card. This number typically contains 16 digits, structured in a specific format to indicate the card network, issuing bank, and account number.

Response example

If your request is successful, you'll receive a 200 response.

{
  "fromBin": 526600000000000000,
  "toBin": 526699999999999999,
  "cardScheme": "MasterCard",
  "issuerName": "Bank of America",
  "issuerCountryCode": "USA",
  "issuerMemberId": "560478",
  "cardType": "MasterCard",
  "fundingSource": "Credit",
  "ownerType": "Consumer",
  "currencyCode": "USD",
  "binLength": 6,
  "gamingCreditSupported": true,
  "productName": "Consumer",
  "productTarget": "USA",
  "isAnonymousProduct": true,
  "rangeType": "W",
  "extendedData": {
    "issuerBin": "441690",
    "issuerName": "Bank of America",
    "binLength": 6,
    "minPanLength": 15,
    "maxPanLength": 15,
    "cashbackEligibility": "N",
    "tokenIndicator": "N",
    "productRegulationValue": "NA",
    "lastUpdate": "2007-01-29",
    "cpsOption": "N",
    "productType": "Commercial",
    "productTypeId": "Commercial",
    "countryCodeNumeric": "840"
  },
  "threeDSecureData": {
    "acsStartProtocolVersion": "2.2.0",
    "acsEndProtocolVersion": "2.2.0",
    "methodURL": "http://max2.biz",
    "dsStartProtocolVersion": "2.2.0",
    "dsEndProtocolVersion": "2.2.0"
  }
}