---
title: "List transactions across all account connections in the workspace"
method: GET
path: "/v2/account-connections/transactions"
tags: ["Account Connections"]
---

# List transactions across all account connections in the workspace

`GET /v2/account-connections/transactions`

Fans out across every connection-linked account in the caller workspace and returns the merged list of transactions, sorted newest-first, capped at `size` (default 5). Pagination is opaque token (cursor) based — pass meta.next_cursor back as `?cursor` to fetch the next page; null next_cursor means no more results. Connections whose provider does not support transactions, or that fail to fetch, are skipped.

## Query parameters

- `cursor` string
- `size` number
- `tokens` string[]
- `start_time` string, date-time
- `end_time` string, date-time
- `status` string[]
- `min_usd` number
- `max_usd` number
- `string_search` string
- `account_id` string, uuid
- `group_ids` string[]
- `categories` string[]

## Response `200`

- SearchWorkspaceConnectionTransactionsResponseDto
  - `items` CanonicalConnectionTransactionDto[], required
    - `id` string, required — Provider-native unique identifier for this event.
    - `transaction_id` string — Persisted row id for this transaction. Present on reads from storage; absent on live adapter responses. Used to update category.
    - `account_id` string, required — Account (in this API) the event belongs to.
    - `provider` object, required — Connection provider that produced this event.
    - `kind` 'TRANSFER' | 'TRADE', required — Discriminator: which event-specific payload is populated.
    - `status` 'PENDING' | 'CONFIRMED' | 'FAILED', required
    - `timestamp` string, nullable — Canonical event time (ISO 8601).
    - `hash` string, nullable
    - `network` string, nullable
    - `block_number` string, nullable
    - `usd_amount` string, nullable — Unsigned USD magnitude for this event (transfer notional or trade notional). Encrypted at rest with the financial payload; used by min_usd / max_usd filters.
    - `transfers` TransferEventDto[], nullable — Value movement legs. Populated when kind === 'TRANSFER' (may be empty when the provider has not parsed the underlying transfers yet).
      - `direction` 'IN' | 'OUT' | 'SELF', required
      - `asset` string, nullable
      - `amount` string, nullable — Quantity moved, in asset units.
      - `usd_amount` string, nullable — USD valuation at event time. Unsigned magnitude; direction conveys sign.
      - `source_address` string, nullable
      - `destination_address` string, nullable
    - `trade` TradeEventDto
      - `side` 'BUY' | 'SELL', required
      - `base_asset` string, nullable
      - `base_amount` string, nullable
      - `quote_asset` string, nullable
      - `quote_amount` string, nullable — Notional in quote asset units (price × base amount).
      - `price` string, nullable
      - `fee` string, nullable
      - `fee_asset` string, nullable — Asset the fee was charged in, when known.
      - `realized_pnl` string, nullable — Realised PnL for a position-closing fill (perps). Null/absent for opens and spot.
      - `liquidation` boolean — True when the fill was a forced liquidation rather than a user-initiated trade.
    - `category` string, nullable — User-assigned category label. Null when unset. Survives provider re-sync.
    - `raw` object, required — Provider-native fields that are not part of the canonical shape (escape hatch; never relied upon by consumers).
  - `meta` CursorMetaDto, required
    - `next_cursor` string, nullable — Opaque string cursor pointing to the next page of results. null if there is no next page.
    - `previous_cursor` string, nullable — Opaque string cursor pointing to the previous page of results. null if there is no previous page.
    - `first_page_cursor` string — Opaque string cursor pointing to the very first page in the entire dataset with respect to the current filter.
    - `last_page_cursor` string, nullable — Opaque string cursor pointing to the very last page in the entire dataset with respect to the current filter.
    - `total_count` number, nullable — Total number of results.
    - `page_number` number — Current page number.

---

[API](https://skmtc.net/range/apis/range-platform-api.md) · [All operations](https://skmtc.net/range/apis/range-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/range/range-platform-api/versions/9926df2e476d/schema)