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

# List Cards

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

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/card-list`
- Auth: API key in header `x-access-token`

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.
- `batchNo` string: Batch number
- `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
      - `email` string: email bind to card
      - `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.
      - `cardReferenceId` string: Unique identifier for physical cards
      - `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
        - `controlId` string: The current limit ID is regenerated after each limit update.
      - `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, 7015:Upgraded from virtual to physical via API
        - `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/infinity-card.md) - [All operations](https://skmtc.dev/interlace/apis/infinity-card/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/infinity-card/revisions/2d542b383dd3?raw)