---
title: "BIN Lookup"
method: GET
path: "/bin-lookup"
tags: ["E-commerce"]
---

# BIN Lookup

`GET /bin-lookup`

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

## Query parameters

- `bin-number` string, required
- `customer-ip` string

## Response `200`

OK

- BINLookupResponse — Structure of bin-lookup
  - `country` string, required — The full country name of the issuer
  - `ip-city` string, required — The city of the customers IP (if detectable)
  - `ip-matches-bin` boolean, required — True if the customers IP country matches the BIN country
  - `card-type` string, required — The card type, will always be one of: DEBIT, CREDIT, CHARGE CARD
  - `card-category` string, required — The card category. There are many different card categories the most common card categories are: CLASSIC, BUSINESS, CORPORATE, PLATINUM, PREPAID
  - `ip-country-code` string, required — The ISO 2-letter country code of the customers IP
  - `ip-country` string, required — The country of the customers IP
  - `issuer` string, required — The card issuer
  - `ip-blocklisted` boolean, 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>
  - `valid` boolean, required — Is this a valid BIN or IIN number
  - `ip-blocklists` string[], required — An array of strings indicating which blocklists this IP is listed on
  - `issuer-website` string, required — The card issuers website
  - `country-code` string, required — The ISO 2-letter country code of the issuer
  - `ip-region` string, required — The region of the customers IP (if detectable)
  - `card-brand` string, required — The card brand (e.g. Visa or Mastercard)
  - `issuer-phone` string, required — The card issuers phone number
  - `country-code3` string, required — The ISO 3-letter country code of the issuer
  - `currency-code` string, required — ISO 4217 currency code associated with the country of the issuer
  - `ip-country-code3` string, required — The ISO 3-letter country code of the customers IP
  - `is-commercial` boolean, required — Is this a commercial/business use card
  - `is-prepaid` boolean, required — Is this a prepaid or prepaid reloadable card
  - `bin-number` string, 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-reloadable` boolean, required — Indicates the card can be reloaded with funds. This is mostly useful to distinguish between non-reloadable and reloadable prepaid card types

## Other responses

- `400` — Your API request has been rejected. Check error code for details
- `403` — You have failed to authenticate
- `500` — We messed up, sorry! Your request has caused a fatal exception
- `default` — We messed up, sorry! Your request has caused an error

---

[API](https://skmtc.net/neutrinoapi/apis/neutrino-api.md) · [All operations](https://skmtc.net/neutrinoapi/apis/neutrino-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neutrinoapi/neutrino-api/versions/4ebd6b56de42/schema)