BIN Lookup API
The BIN Lookup API allows you to look up bank information from Bank Identification Numbers (BIN). Our database contains hundreds of thousands of BINs worldwide.
From 2,803 users
Applications using this API
API Status
API Response Times
Average | P50 | P75 | P90 | P95 |
|---|---|---|---|---|
| 346ms | 382ms | 435ms | 720ms | 1264ms |
Similar APIs
Didn't find what you were looking for? Suggest an improvement
/v2/bin GET
https://api.api-ninjas.com/v2/bin
Returns detailed information about a bank based on the BIN number provided.
Parameters
binrequiredThe Bank Identification Number (BIN) to look up. This is typically the first 6 or 8 digits of a credit card number.
Headers
X-Api-KeyrequiredAPI Key associated with your account.
Response
A JSON array of objects, each containing the following fields, or an error if the request is unsuccessful.
binThe Bank Identification Number that was looked up.
brandpremium onlyThe card brand (e.g. Visa, Mastercard, American Express).
typepremium onlyThe type of card. Possible values are
creditordebit.categoriespremium onlyAn array of category tags for the card. Possible categories include:
Group Category Value Description Payment Type prepaidLoaded funds before use creditTraditional credit with billing cycle debitDirect bank account link chargeFull payment required each cycle atmCash withdrawal only Cardholder Segment personalIndividual consumers businessSmall/medium businesses corporateLarge enterprises & B2B governmentPublic sector Card Tier basicEntry-level (Classic, Standard) mid-tierEnhanced (Gold, Platinum) premiumHigh-end (Signature, Infinite, World) luxuryUltra-premium (Black, Centurion, World Elite) Specialized Use travelT&E and travel expenses purchasingProcurement cards fleetVehicle/fuel expenses giftGift cards and vouchers payrollSalary disbursement benefitsFSA, flex benefits, workplace programs healthcareHSA and medical expenses rewardsCashback and points programs agriculturalFarming operations mealFood-restricted purchases Form Factor virtualDigital-only cards Special Category proprietaryPrivate label/store-specific vpayV PAY network mixedMultiple/uncategorized types issuerpremium onlyThe name of the bank or financial institution that issued the card.
country_iso2The two-letter country code (ISO-3166-1 alpha-2) of the issuing bank.
countryThe full name of the country where the card was issued.
is_validpremium onlyIndicates whether the BIN is valid. Returns
trueif the BIN is valid,falseotherwise.
Sample Request Live Demo!
Try our APIs in the API playground
Sign up for a free API key to get started — no credit card required.
https://api.api-ninjas.com/v2/bin?bin=405316Headers
X-Api-KeyLog in or sign up to get your API KeySample Response
Code Examples
1
2
curl -X GET "https://api.api-ninjas.com/v2/bin?bin=405316" \
-H "X-Api-Key: YOUR_API_KEY"If your programming language is not listed in the Code Example above, you can still make API calls by using a HTTP request library written in your programming language and following the above documentation.
Frequently Asked Questions
Can I use the BIN API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the BIN API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the BIN API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the BIN API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.How do I look up a BIN with the BIN API?
Send a GET request to/v2/binwith the requiredbinparameter, which is typically the first 6 digits of a credit card number (e.g.bin=405316). You can create a free account to get an API key and try it out.What does the BIN API response include?
The API returns a JSON array of objects with fields such asbin,brand(e.g. Visa, Mastercard, American Express),type(creditordebit),categories,issuer,country_iso2,country, andis_valid. Several of these fields includingbrand,type,categories,issuer, andis_validare available on premium plans.What do the categories values in the response mean?
Thecategoriesfield is an array of tags describing the card, grouped by payment type (e.g.prepaid,credit,debit), cardholder segment (e.g.personal,business,corporate), card tier (e.g.basic,premium,luxury), and specialized use (e.g.travel,fleet,healthcare). This field is a premium feature; see the full category table on the documentation page above.What are some use cases for the BIN API, and what other financial lookups does API Ninjas offer?
The BIN API is useful for payment validation, fraud screening, identifying a card's issuing bank and country, and routing transactions by card brand or type using fields likebrand,issuer, andcountry. For related financial lookups, see the IBAN, SWIFT Code, Routing Number, and Sanctions Screening APIs, or browse all API Ninjas APIs.