---
title: "Get treasury transactions"
method: GET
path: "/treasury/{treasuryId}/transactions"
tags: ["Treasury"]
---

# Get treasury transactions

`GET /treasury/{treasuryId}/transactions`

Retrieve paginated treasury transactions for a specific treasury account.

## Path parameters

- `treasuryId` string, uuid, required — ID for a Mercury account.

## Query parameters

- `limit` integer — Maximum number of results to return. Defaults to 100
- `order` 'asc' | 'desc' — Sort order for transactions. Can be 'asc' or 'desc'. Defaults to 'desc'
- `cursor` integer — Pagination cursor for retrieving next batch of transactions. Must be an integer >= 0

## Response `200`

- TreasuryTransactionsResponse — Response type for treasury transactions API endpoint
  - `cursor` integer, nullable — Pagination cursor for retrieving next batch of transactions
  - `transactions` TreasuryTxn[], required — List of treasury transactions in the response
    - `accountId` string, uuid, required — ID for a Mercury account.
    - `additionalDetails` string, nullable
    - `amount` number, required
    - `balance` number, required
    - `canonicalDay` string, date, required
    - `description` string, required
    - `details` TreasuryTransactionDetails
      - `creditDescription` string, nullable
      - `depositCounterpartyId` string, uuid — ID for a Mercury account.
      - `feeDescription` string, nullable
      - `manualAmendmentDescription` string, nullable
      - `security` string, nullable
      - `sweepDirection` string, nullable
      - `tradeAction` string, nullable
      - `withdrawalCounterpartyId` string, uuid — ID for a Mercury account.
    - `id` string, uuid, required — ID for this treasury transaction
    - `security` string, nullable
    - `type` 'depositCanceled' | 'depositComplete' | 'depositFailed' | 'depositReturned' | 'mercuryFeePosted' | 'mercuryFeeFailed' | 'mercuryFeeRefunded' | 'mercuryFeeCanceled' | 'withdrawalPosted' | 'withdrawalFailed' | 'withdrawalCanceled' | 'withdrawalReturned' | 'revertTxn' | 'interestPosted' | 'interestCanceled' | 'manualAmendmentPosted' | 'mercuryCreditPosted' | 'mercuryCreditFailed' | 'dividendPosted' | 'dividendCanceled' | 'dividendReinvestmentPosted' | 'mutualFundTradeFailed' | 'mutualFundTradePosted' | 'sweepInPosted' | 'sweepOutPosted' | 'sweepReconcilePosted' | 'valuationChangePosted' | 'oemsMutualFundOrderSettled' | 'oemsMutualFundOrderCanceled' | 'oemsMutualFundOrderRejected', required

## Other responses

- `400` — Invalid `cursor` or `order` or `limit`
- `404` — `treasuryId` not found

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/versions/0bdf4a496e03/schema)
