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

# List Complex Orders

`GET /v1/complex-orders`

List complex orders (conditional and iceberg) with optional filters.

Returns a dict keyed by complex order type (`conditional_orders`,
`iceberg_orders`). Use `complex_order_type` to restrict to one type.

## Query parameters

- `complex_order_type` string, nullable — Filter by complex order type: CONDITIONAL, TWAP, ICEBERG, PEG.
- `status` string[], nullable — Filter by status name. Interpreted per complex_order_type (ConditionalOrderStatus for CONDITIONAL, IcebergOrderStatus for ICEBERG, PegOrderStatus for PEG). Unknown names for the active type are ignored.
- `river_id` integer, nullable — Filter by instrument ID
- `generic_asset_id` string, uuid, nullable — Filter by generic asset basket ID
- `subaccount_id` string, uuid, nullable — Filter to a specific subaccount
- `complex_order_ids` string[], nullable — Filter by complex order IDs
- `parent_river_order_id` string, uuid, nullable — Filter by parent order ID
- `unparented_only` boolean — When true, only return conditional orders with no parent_river_order_id (standalone stops). Ignored for non-conditional types.
- `limit` integer — Results per page (max 1000)
- `offset` integer — Pagination offset

## Response `200`

Successful Response

- ComplexOrderListResponse — Schema for list of complex orders (all types).
  - `complex_orders` object, required — List of complex orders matching the query
  - `count` integer, required — Total count of matching complex 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/c90d562d4ad1/schema)