---
title: "Get List"
method: POST
path: "/fetch-card"
---

# Get List

`POST /fetch-card`

API call to get the list of vault records for a merchant and customer combination

## Request body

- object
  - `user` object, required — Customer information
    - `externalId` string, required — Customer Id. ExternalId against which Cards are stored
  - `entity` object, required — Merchant information
    - `entityId` string, required — Merchant Id

## Response `200`

- object
  - `status ` object, required — Status
    - `status` string, required — Status of the request
  - `card` object, required — Card Information
    - `type` number, required — Card Type whether CC/DC/PP. Example- 130-CC, 110-DC, 131-PP
    - `expiryMm` string, required — Expiry month of the card. Example- xx
    - `expiryYy` string, required — Expiry year of the card. Example- xxxx
    - `name` string, required — Name on the card
    - `scheme` number, required — Card Network. Example-103: Visa, 104: MC, 105: AMEX, 199: RuPay
    - `bankId` string — Issuer Bank Id
    - `remark` string, required — Any remarks
    - `vaultId` string, required — Vault Id
    - `maskedNumber` string, required — Masked Card Number. Example-Xxxxxxxxxxxx1234
    - `product` string — Product information for the card number
    - `countryCode` string — Country code
    - `par` string, required — PAR value
    - `tokenReference` string, required — Token Reference Id
    - `bankName` string — Issuer Bank Name
    - `status` boolean, required — Status of the record. Example-ACTIVE/INACTIVE
    - `isExpired` boolean, required — Whether the card is expired. Example-true/false
    - `isDomestic` boolean, required — Whether the card is domestic. Example-true/false
    - `cvvLess` number — Example- 1/0
    - `secure` object, required
      - `tokenExpiry` string, required — Expiry of the Token. Format: mmyyyy
  - `foodCard` object — This will always be empty
  - `upiVpa` object — This will always be empty
  - `bankAccount` object — This will always be empty
  - `prePaidInstrument` object — This will always be empty
  - `preferredBank` object — This will always be empty

---

[API](https://skmtc.net/jiopay/apis/jiopay-pg.md) · [All operations](https://skmtc.net/jiopay/apis/jiopay-pg/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jiopay/jiopay-pg/versions/55aa41b8482f/schema)