---
title: "GET /getCardInfo"
method: GET
path: "/getCardInfo"
tags: ["GET"]
---

# GET /getCardInfo

`GET /getCardInfo`

Fetches information about a card based on its IIN.

## Query parameters

- `MerchantId` string, uuid, required — The 36 character GUID which identifies the supplier to the Reach system.
- `IIN` integer, required — The 8-digit IIN (Issuer Identification Number) of the card. Previously known as the BIN, this is the first 8 digits of the card for which info should be fetched. Only values between 10000000 and 99999999 are accepted.
- `Callback` string — JSONP Javascript function name.

## Response `200`

Information about the card was successfully retrieved.

- object
  - `IIN` integer, required — The 8-digit IIN (Issuer Identification Number) of the card. Previously known as the BIN, this is the first 8 digits of the card for which info should be fetched. Only values between 10000000 and 99999999 are accepted.
  - `PaymentMethod` string, required — The Reach payment method associated with this IIN.
  - `Type` 'Credit' | 'Debit' — If known, this will be either Credit or Debit.
  - `PrePaid` boolean — If known, a flag indicating if the card is a pre-paid card.
  - `IssuingCountry` string — If known, the country from which the card was issued.
  - `Available` boolean — If false, this is a known IIN, but cannot be processed via Reach.

## Other responses

- `400` — If present, the getCardInfo request structure was invalid and unable to be parsed.
- `404` — If present, a value of the request was unable to be found. For example, if the MerchantId provided could not be found in the given environment
- `503` — There was a system problem and the request should be tried again.

---

[API](https://skmtc.net/withreach/apis/reach-checkout-api.md) · [All operations](https://skmtc.net/withreach/apis/reach-checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/withreach/reach-checkout-api/versions/f95f4b8dd180/schema)
