---
title: "Get a single connection transaction by id"
method: GET
path: "/v2/account-connections/transactions/{transactionId}"
tags: ["Account Connections"]
---

# Get a single connection transaction by id

`GET /v2/account-connections/transactions/{transactionId}`

Fetches one persisted connection transaction by its transaction id (the `transaction_id` field returned by the list endpoints), scoped to the caller workspace.

## Path parameters

- `transactionId` string, required

## Response `200`

- CanonicalConnectionTransactionDto
  - `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).

---

[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)