---
title: "List Budget Transactions"
method: GET
path: "/open-api/v3/budgets/transactions"
tags: ["Budgets"]
---

# List Budget Transactions

`GET /open-api/v3/budgets/transactions`

## Query parameters

- `id` string, uuid — The UUID of the transaction.
- `accountId` string, uuid, required — The UUID of the account.
- `budgetId` string, uuid — The UUID of the budget.
- `clientTransactionId` string — User-provided custom transaction ID.
- `cardReferenceId` string — This value corresponds to the unique identifier you assigned when creating the card.
- `startTime` string, timestamp, required — Transaction start time. (Required, format: timestamp, interval with endTime must not exceed 3 months)
- `endTime` string, timestamp, required — Transaction end time. (Required, format: timestamp, interval with startTime must not exceed 3 months)
- `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

- BudgetTransactionPageRespDTO
  - `code` string — Error code
  - `message` string — Error message
  - `data` BudgetTransactionPageResponse, required — data
    - `total` integer, required — total number
    - `list` BudgetTransaction[], required — data list
      - `id` string, required — The UUID of the transaction.
      - `accountId` string, required — The UUID of the account.
      - `budgetId` string, required — The UUID of the budget.
      - `cardId` string — The UUID of the card.
      - `amount` string, required — Transaction amount
      - `fee` string, required — Transaction fee
      - `feeDetails` FeeDetail[], required — Transaction feeDetails
        - `amount` string — Amount
        - `currency` string — Currency code
        - `feeType` string — Fee Type: 0:Platform Settlement Fee, 1:Apple Pay Fee, 2:ATM Withdrawal Fee, 3:Reversal Fee, 4:Refund Fee
      - `clientTransactionId` string, required — User-provided custom transaction ID.
      - `transactionDisplayId` string, required — Transaction displayId
      - `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.
      - `transactionCurrency` string — Original transaction currency
      - `transactionAmount` string — Original transaction amount
      - `type` string — Transaction type: 0:TransferIn, 1:TransferOut, 2:CreateCardFee, 3:Consumption, 4:Refund, 5:FeeCredit, 6:Fee_Consumption, 7:Declined_Fee, 8:Reversal
      - `status` string, required — Transaction status
      - `createTime` string, timestamp, required — Transaction time timestamp.
      - `detail` string — Transaction detail
      - `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)

## Other responses

- `400` — Bad Request

---

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