BIN Lookup

How It Works

The BIN Lookup API allows you to retrieve detailed information about a Bank Identification Number (BIN), which is the first 6-8 digits of a credit or debit card. By using this service, you can validate card details, identify card type, issuing bank, and even detect prepaid or commercial cards. This helps reduce fraud, ensure proper processing of transactions, and provide insights into the card's origin and type.

Key Features:

• Identifies card brand, type, and level (e.g., MasterCard, Debit, Prepaid).
• Provides issuing bank details, including name, phone, and website.
• Detects whether the card is prepaid or commercial.
• Provides information about the country of issuance, including currency, language, and region.
• Confirms the validity of the BIN.

Integration

Endpoint:

/api/binlookup

Method:

POST

Base URL:

https://api.boltidentity.com/

Request Headers

{
  "licenseKey": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

Request Body

{
  "bin": "531178"
}

Example Request (Using Fetch)

const response = await fetch('https://api.boltidentity.com/binlookup', {
    method: 'POST',
    headers: {
        'licenseKey': 'YOUR_API_KEY',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        bin: "531178"
    })
});

const data = await response.json();

Sample Response

{
"Bolt-Identity": {
"clientId": "FPC0001",
"apiService": "binLookup",
"requestType": "Free",
"report": {
"referenceID": "fpfr-ryu51cyeie",
"jsonResponse": {
"binPulse": {
"status": "Verified",
"message": "The provided BIN number is successfully Verified.",
"response": {
"brand": "MASTERCARD",
"country": {
"name": "ITALY",
"capital": "Rome",
"currency": "EUR",
"currencyName": "Euro",
"currencySymbol": "€",
"flag": "🇮🇹",
"language": "Italian",
"languageCode": "IT",
"native": "Italia",
"numeric": "380",
"countryCode": "39",
"iso2": "IT",
"region": "Europe",
"subregion": "Southern Europe"
},
"currency": "EUR",
"commercial": "false",
"prepaid": "true",
"issuer": {
"name": "INTESA SANPAOLO SPA",
"phone": "+39064462031",
"website": "http://www.intesasanpaolo.com"
},
"length": 6,
"level": "PREPAID",
"number": 531178,
"scheme": "MASTERCARD",
"type": "DEBIT",
"valid": true
}
}
},
"apiKeyUsed": "api-key-1728234535454-4b4i42ur874",
"requestDateTime": "2025-01-26T10:31:09.993Z"
},
"_id": "67960eedf49dead56388729f",
"createdAt": "2025-01-26T10:31:09.995Z",
"updatedAt": "2025-01-26T10:31:09.995Z",
"__v": 0
}
}

Understand Response

Field	Description	Possible Values / Example
status	Indicates the overall status of the BIN validation request.	Verified, Declined
message	Provides additional information about the request status.	"The provided BIN number is successfully Verified.", "High risk BIN detected."
brand	The card brand associated with the BIN.	"MASTERCARD", "VISA", "AMEX"
country	Provides detailed information about the country of issuance.	Nested JSON object (see below).
currency	The currency of the card's issuing country.	"EUR"
commercial	Indicates whether the card is commercial.	true or false
prepaid	Indicates whether the card is prepaid.	true or false
issuer.name	Name of the issuing bank.	"INTESA SANPAOLO SPA"
issuer.phone	Phone number of the issuing bank.	"+39064462031"
issuer.website	Website of the issuing bank.	"http://www.intesasanpaolo.com"
length	The length of the BIN.	Integer. Example: 6
level	The level of the card (e.g., Prepaid, Business).	"PREPAID"
number	The BIN number being validated.	Example: 531178
scheme	The card scheme or network.	"MASTERCARD", "VISA"
type	The card type (e.g., Debit, Credit).	"DEBIT", "CREDIT"
valid	Indicates if the BIN is valid.	true or false
country.name	Name of the issuing country.	"ITALY"
country.capital	Capital city of the issuing country.	"Rome"
country.currency	Currency code of the issuing country.	"EUR"
country.language	Language spoken in the issuing country.	"Italian"
country.languageCode	Language code of the issuing country.	"IT"
country.flag	Emoji representation of the country flag.	"🇮🇹"
country.region	Region of the issuing country.	"Europe"
country.subregion	Sub-region of the issuing country.	"Southern Europe"