---
title: "Card bin lookup"
method: POST
path: "/v1/cards/bin"
tags: ["/v1/cards"]
---

# Card bin lookup

`POST /v1/cards/bin`

Returns card information based on the BIN (Bank Identification Number).

## Request body

- CardsBinRequest
  - `bin` string, required — The BIN (Bank Identification Number), must be numeric and 6 to 8 digits long

## Response `200`

BIN successfully processed

- CardsBinResponse
  - `brand` string — The brand of the credit card (e.g. VISA CREDIT).
  - `coBrand` string — The coBrand of the card
  - `type` 'CREDIT' | 'DEBIT' | 'PREPAID' — The type of the card (`CREDIT`, `DEBIT` or `PREPAID`). The property will not be present if the card type is unknown.
  - `usage` 'CONSUMER' | 'CORPORATE' — The usage of the card (`CONSUMER`, `CORPORATE`)
  - `country` string — 2 letter ISO 3166-1 alpha-2 country code
  - `issuer` string — The issuer of the card
  - `accountType` 'PAN' | 'TOKEN' — Indicates how the card is identified: `PAN` (the actual card number) or `TOKEN` (a tokenized surrogate, such as a network or device token).
  - `binLength` integer — The bin length, if known.

## Other responses

- `400` — Invalid BIN request

---

[API](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints.md) · [All operations](https://skmtc.dev/pci-proxy/apis/pci-proxy-api-reference-datatrans-endpoints/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pci-proxy/pci-proxy-api-reference-datatrans-endpoints/revisions/1f4f905fd175/schema)