---
title: "List Orders"
method: GET
path: "/v1/orders"
tags: ["orders"]
---

# List Orders

`GET /v1/orders`

List orders with optional filters.

Returns a paginated list of orders across all accessible subaccounts, ordered by `created_at` descending.

**Filters:**
All filters are optional and can be combined. If no `subaccount_id` is specified,
returns orders from all subaccounts the user has access to.

**Order Statuses:**
- `PENDING_SUBMISSION`: Order received, awaiting exchange submission.
- `PROCESSING`: Being processed by the order consumer.
- `RESTING`: Live on the exchange order book (may include partially-filled live orders).
- `EXECUTED`: Terminal — fully filled.
- `PARTIALLY_FILLED`: Terminal — cancelled with some quantity filled.
- `CANCELLED`: Terminal — cancelled with no fills.
- `REJECTED`: Rejected by exchange (see order details for reason).

**Aggregated Fields:**
Each order includes `traded_qty`, `average_price`, and `fees_paid` computed from fills.

## Query parameters

- `status` string, nullable — Filter by order status. Accepts a single OrderStatus name (e.g. 'RESTING') or the meta-value 'ACTIVE' which resolves to RESTING.
- `river_id` integer, nullable — Filter by instrument ID
- `generic_asset_id` string, uuid, nullable — Filter by generic asset ID
- `subaccount_id` string, uuid, nullable — Filter to a specific subaccount
- `parent_iceberg_order_id` string, uuid, nullable — Filter to child tranches of a specific iceberg parent.
- `parent_peg_order_id` string, uuid, nullable — Filter to child tranches of a specific peg parent.
- `parent_smart_taker_order_id` string, uuid, nullable — Filter to IOC children of a specific smart-taker parent.
- `buy_flag` boolean, nullable — Filter by direction: true=buys, false=sells
- `search` string, nullable — Free-text search across the order's market: ticker/slug, the human-readable question (event title, market name, outcome) via full-text + substring match, plus the order's river_id / order id / generic asset id. Applied server-side over all matching orders, not just the current page.
- `show_tp_sl_active` boolean — When true, complex_order_ids only includes attached TP/SL orders with status PENDING or ACTIVE.
- `limit` integer — Results per page (max 1000)
- `offset` integer — Pagination offset

## Response `200`

Successful Response

- OrderListResponse — Schema for list of orders.
  - `orders` OrderResponse[], required — List of orders matching the query
    - `river_order_id` string, uuid, required — Unique order identifier
    - `order_type` string, required — Order type: LIMIT or MARKET
    - `time_in_force` string, required — Time in force: FOK, GTC, GTD, or IOC
    - `qty` number, required — Original order quantity
    - `price` number, nullable — Limit price (null for market orders)
    - `buy_flag` boolean, required — Order direction: true=buy, false=sell
    - `post_only` boolean — Whether the order is post-only (maker-only)
    - `cancel_order_on_pause` boolean — Kalshi only: whether the exchange cancels the resting order during a trading pause
    - `status` string, required — Order status. Live: PENDING_SUBMISSION, PROCESSING, RESTING. Terminal: EXECUTED, PARTIALLY_FILLED (cancelled with some fills), CANCELLED, REJECTED.
    - `river_id` integer, nullable — Instrument ID
    - `generic_asset_id` string, uuid, nullable — Generic asset basket UUID
    - `subaccount_id` string, uuid, required — Subaccount the order belongs to
    - `expiry_ts_utc` string, nullable — Expiry timestamp in UTC for GTD orders
    - `created_at` string, required — Order creation timestamp (UTC)
    - `updated_at` string, required — Last update timestamp (UTC)
    - `traded_qty` number — Total quantity filled
    - `average_price` number, nullable — Volume-weighted average fill price
    - `fees_paid` number — Total fees paid across all fills
    - `complex_order_ids` object, required — List of complex river orders id
    - `reject_reason` string, nullable — Reason for rejection (if status is REJECTED)
    - `parent_iceberg_order_id` string, uuid, nullable — If this order is a tranche of an iceberg parent, the parent's id; otherwise null.
    - `parent_peg_order_id` string, uuid, nullable — If this order is the resting child of a peg parent, the parent's id; otherwise null.
    - `parent_smart_taker_order_id` string, uuid, nullable — If this order is an IOC child of a smart-taker parent, the parent's id; otherwise null.
  - `count` integer, required — Total count of matching orders (for pagination)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/rivermarkets/apis/river-finance-api.md) · [All operations](https://skmtc.net/rivermarkets/apis/river-finance-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivermarkets/river-finance-api/revisions/3776a0431319/schema)