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

# List Budget Transactions

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

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/budgets/transactions`
- 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.
- `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 - 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, 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, 9:System_Fee, 10:Verification_Fee
      - `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.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)