---
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`

## Request

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

## 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, 16:Verification_Fee
- `status` string: Transaction status. values: `CLOSED`,`PENDING`,`FAIL`
- `batchNo` string: Transaction batch number.
- `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 - 13: Cross Border Fee - 14: FX Fee - 15: FINAL_EXTRA_FROZEN
      - `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, 16:Verification_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 currency 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
      - `conversionRate` string: The conversion rate applied to convert the transactionAmount into amount.
      - `cardReferenceId` string: Unique identifier for physical cards
    - `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)