---
title: "List organization transactions"
url: https://docs.truemarkets.co/api/gateway/list-organization-transactions
description: "Orders, transfers and received transfers of every user the organization serves, newest first, each row naming its user. Ramps are not included."
---

Docs index: https://docs.truemarkets.co/llms.txt

# List organization transactions

Orders, transfers and received transfers of every user the organization serves, newest first, each row naming its user. Ramps are not included.

Requires an organization token for this organization, or an admin member of it. `TM-On-Behalf-Of` is rejected.

## Request

```
GET https://api.truemarkets.co/v1/gateway/organizations/{organization_id}/transactions
```

### Authentication

Bearer token in `Authorization`

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `organization_id` | path | string (uuid) | yes | Your organization's id: the `tm.organization_id` claim of an organization token, also shown on the dashboard Overview. |
| `user_id` | query | array of string (uuid) | no | Comma-separated user ids. Defaults to every user served. |
| `type` | query | array of string, one of `order`, `transfer`, `ramp`, `received_transfer` | no | Comma-separated types to include: `order`, `transfer`, `received_transfer`. Defaults to all three; `ramp` is rejected. |
| `status` | query | array of string, one of `pending`, `active`, `completed`, `failed`, `canceled` | no | Comma-separated statuses to include. Defaults to all. |
| `external_ref_id` | query | string | no | Your reference for one served user, as given when the user was created. |
| `asset_symbol` | query | array of string | no | Comma-separated asset symbols, matched exactly. |
| `asset_type` | query | array of string, one of `spot`, `perp` | no | Comma-separated asset types. Returns orders only. |
| `order_type` | query | array of string, one of `market`, `limit`, `take_profit`, `stop_loss` | no | Comma-separated order types. A take-profit or stop-loss order matches only its trigger type. Returns orders only. |
| `asset_class` | query | array of string, one of `crypto`, `stock` | no | Comma-separated asset classes. Returns orders only. |
| `id` | query | string (uuid) | no | One transaction's id. |
| `tx_hash` | query | string | no | One transaction hash, matched regardless of case. |
| `from` | query | string (date-time) | no | Created at or after this instant. |
| `to` | query | string (date-time) | no | Created before this instant. Must be after `from`. |
| `cursor` | query | string | no | Opaque pagination cursor from the previous page's `next_cursor` |
| `limit` | query | integer | no | Maximum number of transactions to return |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Transactions retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | array of object | no | Transactions, newest first |
| `data[].id` | string (uuid) | no | Id of the underlying order, transfer, ramp, or received transfer |
| `data[].type` | string, one of `order`, `transfer`, `ramp`, `received_transfer` | no | Kind of activity a transaction-feed row represents. |
| `data[].asset_flow` | string, one of `in`, `out` | no | Direction the row's asset moved relative to the caller's holdings, for rendering a row without reading the typed object. Scoped to `asset_symbol`, so a buy is `in` even though value moved out. Compose your own label from `type` and this field. |
| `data[].status` | string, one of `pending`, `active`, `completed`, `failed`, `canceled` | no | Lifecycle bucket shared by every type. Each type's native status stays verbatim inside the row's typed object; a received transfer has none and is always `completed`. `active` is an order resting on its venue (`active`, or `cancel_pending` until the cancel lands); `pending` is one not yet live there. |
| `data[].created_at` | string (date-time) | no | When the row was created; for a received transfer, the time of the block that carried it |
| `data[].completed_at` | string (date-time), nullable | no | When the row reached a terminal status; null while in flight |
| `data[].qty` | string, nullable | no | Quantity denominated in `asset_symbol`: executed quantity for a filled order, requested quantity for an unfilled one, tokens sent for a transfer (its base quantity until it sends), settled amount for a ramp, received amount for a received transfer. Null when none is known yet: an unfilled quote-denominated order, a quote-denominated transfer not yet sent, or an unsettled ramp. |
| `data[].asset_id` | string (uuid), nullable | no | Null for ramps until they carry an asset id, and for received transfers |
| `data[].asset_symbol` | string, nullable | no |  |
| `data[].tx_hash` | string, nullable | no | Set once the row settles on-chain |
| `data[].explorer_url` | string, nullable | no | Public block-explorer page for the row: the order's, transfer's, or received transfer's, or the Solana page for a ramp. Null while `tx_hash` is null and for CeFi orders. |
| `data[].failure_reason` | string, nullable | no | Venue-supplied reason, set only on a failed row |
| `data[].order` | object | no | Present only when `type` is `order` |
| `data[].order.order_id` | string | no | Unique order identifier |
| `data[].order.asset_id` | string (uuid), nullable | no | Asset id the order was placed against. May be null for orders sourced directly from the venue. |
| `data[].order.economic_asset_id` | string (uuid), nullable | no | Economic asset the order's listing lists, shared by its listings on every venue and chain. Null when the order recorded none. |
| `data[].order.asset_symbol` | string, nullable | no | Asset symbol the order was placed against. May be null for orders sourced directly from the venue. |
| `data[].order.base_asset` | string | no | Base asset symbol (e.g. `BTC`, `ETH`, `SOL`) |
| `data[].order.quote_asset` | string | no | Quote asset symbol (the CeFi listing's instrument quote, e.g. `PYUSD` or `USDC`; `USDC` for DeFi) |
| `data[].order.type` | string, one of `market`, `limit` | no | The type of order to place — how the order executes. * **market** — Execute immediately at the best available price. Buy orders require `qty_unit: quote`. Price must not be specified. * **limit** — Place an order at a specific price. Requires `price` and `qty_unit: base`. `chain` is optional: omit it for a CeFi limit order, or supply a DeFi chain (e.g. `hypercore-spot`) to rest the order on-chain. With a `trigger`, the type is how the fired order executes and must be `market`. |
| `data[].order.side` | string, one of `buy`, `sell` | no | The side of the order. * **buy** — Purchase the base asset using the quote asset. * **sell** — Sell the base asset in exchange for the quote asset. |
| `data[].order.price` | string, nullable | no | For limit orders, the limit price submitted. For market orders, the reference price at order creation. Null when no price was recorded. |
| `data[].order.qty` | string | no | Original order quantity in the denomination specified by `qty_unit` at creation |
| `data[].order.qty_unit` | string, one of `base`, `quote` | no | Denomination of `qty` at creation |
| `data[].order.executed_qty` | string | no | Quantity of the base asset that has been filled so far |
| `data[].order.leaves_qty` | string | no | Remaining base asset quantity yet to be filled. Zero when the order is complete. |
| `data[].order.executed_vwap` | string | no | Volume-weighted average price across all fills for this order |
| `data[].order.fee` | string | no | Total fee charged for this order in the quote asset, `0` until part of it fills. For CeFi orders this is the cumulative `trade_fee` across all fills; for DeFi orders it is the order's fee once any of it has filled. The fee an order is expected to pay before it fills is the quote's `fee`. |
| `data[].order.tx_hash` | string | no | On-chain transaction hash for DeFi orders. Omitted for CeFi orders. |
| `data[].order.explorer_url` | string | no | Public block-explorer page for the order. Hyperliquid orders link to the wallet's address page on the Hyperliquid explorer, since only the venue order id is recorded. Set on `GET /orders` and the transaction feed, like `asset_type`; omitted for CeFi orders and until the venue has acknowledged the order. |
| `data[].order.failure_reason` | string | no | Human-readable reason the order failed, such as insufficient balance. Present only on failed orders. |
| `data[].order.venue` | string, one of `defi`, `cefi` | no | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `data[].order.chain` | string | no | Chain the DeFi order executed on. Omitted for CeFi orders. |
| `data[].order.status` | string, one of `initialized`, `pending`, `cancel_pending`, `complete`, `canceled`, `active`, `failed` | no | The current status of the order. * **initialized** — Order has been created but not yet submitted. For DeFi orders, the client must sign the returned payloads and call the execute endpoint. For CeFi buy orders with insufficient balance, a funding bridge is prepared first. * **pending** — Order has been submitted but is not yet confirmed by the CeFi exchange or on-chain. * **active** — Order was accepted by the CeFi exchange and is open for trading. Applies to limit orders that are working in the order book. * **cancel_pending** — A cancellation request has been sent to the CeFi exchange and is awaiting confirmation. * **complete** — Order has been fully executed. For CeFi orders this means the CeFi exchange reported a fill; for DeFi orders the on-chain swap was confirmed. * **canceled** — Order was successfully canceled via a cancel request or by exchange/market conditions. * **failed** — Order was rejected by the CeFi exchange or DeFi execution failed (e.g. on-chain transaction reverted, balance check failed). |
| `data[].order.created_at` | string (date-time) | no | Timestamp when the order was created (RFC 3339) |
| `data[].order.asset_type` | string, one of `spot`, `perp` | no | Product type of the traded asset. `perp` for Hyperliquid perpetuals, `spot` otherwise. Lets clients tell perp orders apart from spot ones sharing the same symbol. |
| `data[].order.trigger` | object | no | Set on a TP/SL trigger order, the same shape it was created with. Such an order is a `market` close, so `price` is null while it rests. |
| `data[].order.trigger.type` | string, one of `take_profit`, `stop_loss` | yes | Trigger direction relative to the position. |
| `data[].order.trigger.price` | string | yes | Trigger price per unit of base asset as a decimal string. |
| `data[].order.placed_by` | string, one of `user`, `service` | no | Who placed the order: the user, or a platform service acting for them, such as a strategy trading from their Strategies wallet. |
| `data[].order.strategy_managed` | boolean | no | True on an order a platform service placed for the user (`placed_by` is `service`). It is read-only here: `POST /orders/{id}/cancel` and modify return 422. A live open order conductor has no record of carries its DeFi order id as `order_id`. Omitted otherwise. |
| `data[].transfer` | object | no | Present only when `type` is `transfer` |
| `data[].transfer.id` | string (uuid) | yes | Unique transfer identifier |
| `data[].transfer.status` | string, one of `awaiting_signature`, `pending`, `completed`, `failed` | yes | The current status of the transfer. * **awaiting_signature** — Transfer has been created and is waiting for the client to sign the unsigned payloads and call the execute endpoint. * **pending** — Signed transaction has been submitted and is awaiting on-chain confirmation. * **completed** — Transfer has been confirmed on-chain. * **failed** — Transfer failed due to an on-chain error or rejection. |
| `data[].transfer.venue` | string, one of `defi`, `cefi` | yes | The trading venue to filter by. * **defi** — Decentralized exchange (on-chain swaps). * **cefi** — Centralized exchange (off-chain order book). |
| `data[].transfer.asset_id` | string (uuid) | yes | Asset identifier |
| `data[].transfer.asset_symbol` | string | yes | Asset ticker symbol (e.g. `USDC`, `SOL`) |
| `data[].transfer.chain` | string, nullable | yes | Blockchain network (e.g. `solana`, `base`) for DeFi transfers, or null for CeFi transfers |
| `data[].transfer.network` | string, nullable | yes | Destination network the CeFi withdrawal was submitted on (one of the asset's supported networks from `GET /assets`), or null for DeFi transfers. |
| `data[].transfer.to` | string | yes | Destination wallet address |
| `data[].transfer.qty` | string | yes | Transfer quantity as a decimal string |
| `data[].transfer.qty_unit` | string, one of `base`, `quote` | yes | Unit of the quantity |
| `data[].transfer.sent` | string | yes | Amount sent as a decimal string |
| `data[].transfer.fee` | string | yes | Fee as a decimal string |
| `data[].transfer.received` | string | yes | Amount received as a decimal string |
| `data[].transfer.tx_hash` | string | yes | On-chain transaction hash |
| `data[].transfer.explorer_url` | string, nullable | no | Public block-explorer page for `tx_hash`, null until the transfer is broadcast |
| `data[].transfer.payloads` | array of object | yes | Unsigned transaction payloads for the client to sign. Present when status is `awaiting_signature`; empty array after execution. |
| `data[].transfer.payloads[].digest` | string | yes | Lowercase hex SHA-256 of the `payload` bytes. A signing API that takes a pre-hashed input signs the hex-decoded digest; a library that hashes its input takes `payload` instead. Passing the hex digest to a library that hashes signs the wrong bytes. |
| `data[].transfer.payloads[].payload` | string | yes | The exact text to sign: a Turnkey activity as JSON, including its trailing newline. Sign its UTF-8 bytes as-is with ECDSA P-256 and SHA-256; never decode, reformat or re-serialize it. |
| `data[].transfer.created_at` | string (date-time) | yes | Timestamp when the transfer was created (RFC 3339) |
| `data[].transfer.updated_at` | string (date-time) | yes | Timestamp of the last status update (RFC 3339) |
| `data[].ramp` | object | no | Present only when `type` is `ramp` |
| `data[].ramp.id` | string (uuid) | yes |  |
| `data[].ramp.payment_method` | string, one of `COINBASE`, `PAYPAL`, `APPLE_PAY`, `GOOGLE_PAY` | yes | Rail the ramp is funded or paid out through. DeFi routes the provider from it, so it is the caller's only choice of venue. `APPLE_PAY` and `GOOGLE_PAY` are onramp-only and require a `channel`. |
| `data[].ramp.direction` | string, one of `onramp`, `offramp` | yes |  |
| `data[].ramp.status` | string, one of `created`, `pending`, `completed`, `failed`, `expired` | yes | Ramp lifecycle: `created` until funds move, `pending` while the provider settles, then `completed`, `failed`, or `expired` if it was abandoned before any funds moved. |
| `data[].ramp.amount` | string | yes | Amount requested at creation, in the settlement asset |
| `data[].ramp.chain` | string | yes | Chain the ramp settles on |
| `data[].ramp.asset_symbol` | string | no |  |
| `data[].ramp.asset_amount` | string | no | Amount actually settled |
| `data[].ramp.fiat_currency` | string | no |  |
| `data[].ramp.fiat_amount` | string | no |  |
| `data[].ramp.fee_amount` | string | no |  |
| `data[].ramp.fee_currency` | string | no |  |
| `data[].ramp.exchange_rate` | string | no |  |
| `data[].ramp.wallet_address` | string | no | Address the ramp settles against |
| `data[].ramp.provider_wallet_address` | string | no | Provider deposit address the offramp transfer sends to |
| `data[].ramp.tx_hash` | string | no |  |
| `data[].ramp.redirect_url` | string | no |  |
| `data[].ramp.failure_reason` | string | no |  |
| `data[].ramp.created_at` | string (date-time) | yes |  |
| `data[].ramp.updated_at` | string (date-time) | yes |  |
| `data[].ramp.completed_at` | string (date-time) | no |  |
| `data[].received_transfer` | object | no | Present only when `type` is `received_transfer` |
| `data[].received_transfer.id` | string (uuid) | yes |  |
| `data[].received_transfer.chain` | string | yes | Chain the transfer landed on |
| `data[].received_transfer.tx_hash` | string | yes |  |
| `data[].received_transfer.from_address` | string | yes | Address the transfer came from |
| `data[].received_transfer.to_address` | string | yes | The caller's wallet address it credited |
| `data[].received_transfer.token_address` | string | yes | Contract or mint address of the token received |
| `data[].received_transfer.token_symbol` | string | yes |  |
| `data[].received_transfer.amount` | string | yes | Amount received, in `token_symbol` |
| `data[].received_transfer.observed_at` | string (date-time) | yes | Time of the block that carried the transfer |
| `data[].user_id` | string (uuid) | yes | The served user this transaction belongs to |
| `data[].external_ref_id` | string | yes | Your reference for the served user |
| `pagination` | object | no | Cursor-based pagination metadata. The cursor is opaque and must be passed back verbatim; never parse or construct one. |
| `pagination.next_cursor` | string, nullable | no | Opaque cursor for the next page, null when the feed is exhausted |
| `pagination.limit` | integer | no | Number of items per page |

### 400

Bad request

### 401

Unauthorized

### 403

Forbidden. On order creation this also covers an asset that is not available to trade from the country the request came from.

### 500

Internal server error

### 503

Service unavailable
