This API enables developers to verify the first six digits of a credit or debit card number known as the Bank Identification Number (BIN). The response provides information such as the card brand, sub-brand, issuing bank, country code, and card type.

👍

Test Data

Number: 539941

📘

Post

{{URL}}/identitypass/verification/card_bin

Request Header

KeyDescription
app-idYour App ID
x-api-keyYour Secret Key

Request Body

KeyDescription
NumberBank Identification Number

Sample Response

{
    "status": true,
    "response_code": "00",
    "detail": "Verification Successful",
    "data": {
        "bin": "123456",
        "brand": "mastercard",
        "sub_brand": "",
        "country_code": "NG",
        "country_name": "Nigeria",
        "card_type": "debit",
        "bank": "Zenith Bank",
        "currency": "NGN"
    }
}

Response Description

ResponseDescription
statusindicates that the request was successful
response_codeRepresents the response code.
detailIndicates the outcome of the verification process and states if the verification was successful or not.
dataAn array containing the retrieved card information.
binRepresents the Bank Identification Number (BIN) of the payment card.
brandSpecifies the brand of the payment card.
sub_brandRefers to any sub-brand associated with the payment card.
country_codeRepresents the two-letter country code associated with the payment card.
country_nameProvides the name of the country where the card is issued.
card_typeSpecifies the type of the payment card.
bankIndicates the name of the bank that issued the payment card.
currencyRepresents the currency associated with the payment card.