API Basics
★  Fundamentals
★  Error Codes
★  Examples
★  Batch Processing
★  Specifications
★  Best Practice
★  SDKs
★  Stats
Data Tools
Security and Networking

BIN Lookup

Perform a BIN (Bank Identification Number) or IIN (Issuer Identification Number) lookup.

This API is ideal for fraud protection systems and payment analysis. Find out the card type, country and full issuer details for the given BIN number. Our BIN database is comprehensive and covers all countries, we update it on a weekly basis as new cards are issued. This API also includes some extra fraud detection measures if a customer IP address is passed in. In this mode the API will also perform IP geolocation and IP blocklist lookups. You can also download the complete BIN database for use on your own systems using the Download API

End Point

Test API
API Request
bin-numberyesstringThe BIN or IIN number (the first 6 digits of a credit card number)
customer-ipnostringPass in the customers IP address and we will return some extra information about them
API Response
validbooleanIs this a valid BIN or IIN number
card-brandstringThe card brand (e.g. Visa or Mastercard)
card-typestringThe card type, will always be one of: DEBIT, CREDIT, CHARGE CARD
card-categorystringThe card category. There are many different card categories the most common card categories are: CLASSIC, BUSINESS, CORPORATE, PLATINUM, PREPAID
countrystringThe full country name of the issuer
country-codestringThe ISO 2-letter country code of the issuer
country-code3stringThe ISO 3-letter country code of the issuer
currency-codestringISO 4217 currency code associated with the country of the issuer
issuerstringThe card issuer
issuer-websitestringThe card issuers website
issuer-phonestringThe card issuers phone number
ip-matches-binbooleanTrue if the customers IP country matches the BIN country
ip-countrystringThe country of the customers IP
ip-country-codestringThe ISO 2-letter country code of the customers IP
ip-country-code3stringThe ISO 3-letter country code of the customers IP
ip-regionstringThe region of the customers IP (if detectable)
ip-citystringThe city of the customers IP (if detectable)
ip-blocklistedbooleanTrue if the customers IP is listed on one of our blocklists, see the IP Blocklist API
ip-blocklistsarrayAn array of strings indicating which blocklists this IP is listed on
Daily Limits
Free TierTier 1Tier 2Tier 3