Sign in

v1

latestSwagger 2.02026-07-132830204.5 KB
E-commerce

BIN Lookup

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

get/bin-lookup

Query parameters

bin-numberstring required

The BIN or IIN number. This is the first 6, 8 or 10 digits of a card number, use 8 (or more) digits for the highest level of accuracy

customer-ipstring

Pass in the customers IP address and we will return some extra information about them

Response

OK

countrystring required

The full country name of the issuer

ip-citystring required

The city of the customers IP (if detectable)

ip-matches-binboolean required

True if the customers IP country matches the BIN country

card-typestring required

The card type, will always be one of: DEBIT, CREDIT, CHARGE CARD

card-categorystring required

The card category. There are many different card categories the most common card categories are: CLASSIC, BUSINESS, CORPORATE, PLATINUM, PREPAID

ip-country-codestring required

The ISO 2-letter country code of the customers IP

ip-countrystring required

The country of the customers IP

issuerstring required

The card issuer

ip-blocklistedboolean required

True if the customers IP is listed on one of our blocklists, see the <a href="http://www.neutrinoapi.com/api/ip-blocklist/">IP Blocklist API</a>

validboolean required

Is this a valid BIN or IIN number

ip-blocklistsstring[] required

An array of strings indicating which blocklists this IP is listed on

issuer-websitestring required

The card issuers website

country-codestring required

The ISO 2-letter country code of the issuer

ip-regionstring required

The region of the customers IP (if detectable)

card-brandstring required

The card brand (e.g. Visa or Mastercard)

issuer-phonestring required

The card issuers phone number

country-code3string required

The ISO 3-letter country code of the issuer

currency-codestring required

ISO 4217 currency code associated with the country of the issuer

ip-country-code3string required

The ISO 3-letter country code of the customers IP

is-commercialboolean required

Is this a commercial/business use card

is-prepaidboolean required

Is this a prepaid or prepaid reloadable card

bin-numberstring required

The BIN number returned. You may count the number of digits in this field to determine if the BIN is likely to be based on an 8-digit or 6-digit card

is-reloadableboolean required

Indicates the card can be reloaded with funds. This is mostly useful to distinguish between non-reloadable and reloadable prepaid card types

Example response

{
  "bin-number": "48334884",
  "card-brand": "VISA",
  "card-category": "PLATINUM",
  "card-type": "CREDIT",
  "country": "NEW ZEALAND",
  "country-code": "NZ",
  "country-code3": "NZL",
  "currency-code": "NZD",
  "ip-blocklisted": false,
  "ip-blocklists": [],
  "ip-city": "",
  "ip-country": "",
  "ip-country-code": "",
  "ip-country-code3": "",
  "ip-matches-bin": false,
  "ip-region": "",
  "is-commercial": false,
  "is-prepaid": false,
  "is-reloadable": true,
  "issuer": "KIWIBANK, LTD.",
  "issuer-phone": "",
  "issuer-website": "http://www.kiwibank.co.nz",
  "valid": true
}