---
title: "List Card Transactions"
method: GET
path: "/open-api/v3/cards/transaction-list"
tags: ["Card Transaction"]
---

# List Card Transactions

`GET /open-api/v3/cards/transaction-list`

## Query parameters

- `id` string, uuid — The UUID of the Transaction.
- `accountId` string, uuid, required — The UUID of the Account. (The default value is the master account id)
- `clientTransactionId` string — Client transaction id.
- `cardId` string, uuid — The UUID of the Card.
- `type` string — Transaction type: Values: 0:Credit, 1:Consumption, 2:TransferIn, 3:TransferOut, 9:Fee_Consumption, 10:Declined_Fee, 14:Reversal, 15:System_Fee
- `status` string — Transaction status. values: `CLOSED`,`PENDING`,`FAIL`
- `startTime` string, timestamp — Transaction start time.
- `endTime` string, timestamp — Transaction end time.
- `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

- CardTransactionListResponse — card transaction resources list
  - `code` string — Return code
  - `message` string — Error message
  - `data` PageResourceCardTransactionResource — Returned data
    - `list` CardTransactionResource[] — List of data items
      - `id` string
      - `accountId` string — Associated account ID
      - `cardId` string — Associated card ID
      - `cardholderId` string — Cardholder ID
      - `cardTransactionId` string — Card transaction ID
      - `currency` string — Currency code
      - `amount` string — Transaction amount
      - `fee` string — Transaction fee, The fee is not included in the `amount`.
      - `feeDetails` CardTxFeeDetail[] — Transaction fee details,Detail items of `fee`
        - `amount` string — Amount
        - `currency` string — Currency code
        - `feeType` integer — Fee Type: 0:Platform Settlement Fee, 1:Apple Pay Fee, 2:ATM Withdrawal Fee, 3:Reversal Fee, 4:Refund Fee, 5:Scheme Reversal Fee, 6:Scheme Refund Fee, 7:Scheme Fee - Auth, 8:Scheme Fee - Settlement, 9:Scheme Fee - Service, 10:Scheme Fee - VRM, 11:Scheme Fee - Verification, 12:Scheme Fee - Signature
      - `clientTransactionId` string — Client custom transaction ID
      - `relatedCardTransactionId` string — Related card transaction ID
      - `transactionDisplayId` string — transaction display id
      - `type` integer — Transaction type: Values: 0:Credit, 1:Consumption, 2:TransferIn, 3:TransferOut, 9:Fee_Consumption, 10:Declined_Fee, 14:Reversal, 15:System_Fee
      - `status` string — Transaction status. values: CLOSED,PENDING,FAIL
      - `merchantName` string — Merchant name
      - `mcc` string — Merchant category code (MCC) ,exists in consumer transactions.
      - `mccCategory` string — Industry category of MCC,exists in consumer transactions.
      - `merchantCity` string — Merchant city,exists in consumer transactions.
      - `merchantCountry` string — Merchant country,exists in consumer transactions.
      - `merchantState` string — Merchant state/province,exists in consumer transactions.
      - `merchantZipcode` string — Merchant postal code,exists in consumer transactions.
      - `merchantMid` string — Merchant identification number (MID),exists in consumer transactions.
      - `transactionTime` string — Transaction time
      - `transactionCurrency` string — Original transaction currency
      - `transactionAmount` string — Original transaction amount
      - `createTime` string — Creation time
      - `completeTime` string — CompleteTime time
      - `remark` string — Reason for transaction failure
      - `detail` string — some merchant info
      - `businessCodeList` integer[] — Business code identifiers. The complete list of supported business codes and their meanings can be found in the [Business Code Reference](https://developer.interlace.money/docs/card-business-code-reference).
      - `direction` integer — Transaction direction: 1 - Credit (incoming funds), 2 - Debit (outgoing funds)
      - `transactionScope` integer — Transaction scope: 0-DOMESTIC, 1-INTERNATIONAL
      - `authorizationCode` string — Authorization code
    - `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)