---
title: "List Cards"
method: GET
path: "/open-api/v3/card-list"
tags: ["Card"]
---

# List Cards

`GET /open-api/v3/card-list`

Fetch detailed information for cards. This includes card status, person card status, limits, and any other relevant data. But nothing sensitive.

## Query parameters

- `accountId` string, uuid, required — The UUID of the Account.
- `cardId` string, uuid — The UUID of the Card.
- `budgetId` string, uuid — The UUID of the budget.
- `cardholderId` string — The ID of the cardholder.
- `label` string — Custom card label or tag
- `status` string — Card status: INACTIVE,CONTROL,ACTIVE,PENDING,FROZEN
- `referenceId` string — Optional filter parameter. When provided, only the card with the matching referenceId will be returned. This value corresponds to the unique identifier you assigned when creating the card.
- `limit` string, number — Limits the number of items to be returned.
- `page` string, number — The page to be returned, counting from 1 as the first page.

## Response `200`

OK

- CardListResponse — card resources list
  - `code` string — Return code
  - `message` string — Error message
  - `data` PageResourceCardResource — Returned data
    - `list` CardResource[] — List of data items
      - `id` string — Unique identifier of the card
      - `accountId` string — Account ID
      - `status` string — Card status. Values: INACTIVE,CONTROL,ACTIVE,PENDING,FROZEN
      - `currency` string — Currency code
      - `bin` string — Card BIN (Bank Identification Number)
      - `userName` string — User name
      - `createTime` string — Card creation time
      - `cardLastFour` string — Last four digits of the card number
      - `billingAddress` AddressResource — Card address
        - `addressLine1` string — First line of the address
        - `addressLine2` string — Second line of the address
        - `city` string — City
        - `country` string — Country
        - `postalCode` string — Postal code
        - `state` string — State
      - `label` string — Card label
      - `balanceId` string — Balance ID
      - `budgetId` string — Budget ID (Only for Budget Card)
      - `cardholderId` string — Cardholder ID
      - `referenceId` string — A unique identifier assigned by you for each card. This value must be unique per card request and will be used later to query or track the corresponding card.
      - `cardMode` 'PHYSICAL_CARD' | 'VIRTUAL_CARD' — Card mode. Example: VIRTUAL_CARD
      - `transactionLimits` TransactionLimitsResource[] — Limit information
        - `type` string — Type of card spending limit. The quota will reset at 00:00 (GMT+8). Values: DAY,WEEK,MONTH,QUARTER,YEAR,LIFETIME,TRANSACTION,NA
        - `value` string — Card spending limit amount
        - `currency` string — Currency code
      - `cardStatusChangeRecordList` CardStatusChangeRecordResource[] — card status change record list
        - `userId` string — user id
        - `accountId` string — account id
        - `cardId` string — card id
        - `operationTime` string — operation time, millisecond timestamp
        - `beforeStatus` string — before status
        - `afterStatus` string — after status
        - `reasonCode` string — reason code:7001:Created via merchant portal, 7002:Created via API, 1001:Closed via Open API, 1002:Closed via merchant portal, 1003:Closed due to risk policy violation, 1004:Closed by administrator, 1005:Closed due to BIN decommission, 1006:Closed due to account termination, 1007:Automatic deletion upon card expiration, 2001:Activated via Open API, 2002:Activated via merchant portal, 3001:Suspended via Open API, 3002:Suspended via merchant portal, 5001:Restricted by administrator, 6001:Unrestricted by administrator,
        - `reasonMessage` string — reason message
        - `requestUrl` string — request url
    - `total` integer — Total number of records

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/interlace/apis/core-resource.md) · [All operations](https://skmtc.dev/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/interlace/core-resource/revisions/29c08a4da357/schema)