# List Orders

> Returns order history for the authenticated user

Source: /trader/api/history/order-history

## `GET /accounts/{account_id}/history/orders`

**List Orders**

Returns order history for the authenticated user

Tags: `History`

#### Path parameters

- `account_id` (string) (required) — Account ID to fetch order history for

#### Query parameters

- `from` (string) — From date created to fetch order history for
- `to` (string) (required) — To date created to fetch order history for


### Responses

#### `200` — Successfully retrieved order history

**Content-Type:** `application/json`

- `orders` (array) (required)
  - items:
    - `id` (string) (required) — Order identifier
    - `account_id` (string) (required) — Account identifier
    - `symbol_id` (string) (required) — Trading symbol identifier
    - `symbol_name` (string) (required) — Symbol display name
    - `position_id` (string) — Related position identifier
    - `client_order_id` (string) — Client-provided order identifier
    - `parent_order_id` (string) — Parent order identifier for bracket orders
    - `cancels_order_id` (string) — Order that this order cancels
    - `created_at` (string) — Order creation timestamp
    - `updated_at` (string) — Order last update timestamp
    - `expiration_date` (string) — Order expiration timestamp
    - `qty_original` (number) (required) — Original order quantity
    - `qty_filled` (number) (required) — Filled quantity
    - `qty_remaining` (number) — Remaining quantity
    - `limit_price` (number) — Limit price for limit orders
    - `stop_price` (number) — Stop price for stop orders
    - `fill_price` (number) — The average fill price (VWAP) for filled/partially filled orders
    - `side` (string) (required) — Trade side (buy/sell)
      - enum: `TRADE_SIDE_UNSPECIFIED`, `TRADE_SIDE_BUY`, `TRADE_SIDE_SELL`
    - `type` (string) (required)
      - enum: `ORDER_TYPE_UNSPECIFIED`, `ORDER_TYPE_MARKET`, `ORDER_TYPE_LIMIT`, `ORDER_TYPE_STOP`, `ORDER_TYPE_STOP_LIMIT`, `ORDER_TYPE_TRAILING_STOP`
    - `status` (string) (required)
      - enum: `ORDER_STATUS_UNSPECIFIED`, `ORDER_STATUS_INACTIVE`, `ORDER_STATUS_WORKING`, `ORDER_STATUS_FILLED`, `ORDER_STATUS_CANCELED`, `ORDER_STATUS_REJECTED`, `ORDER_STATUS_EXPIRED`, `ORDER_STATUS_PARTIALLY_FILLED`
    - `time_in_force` (string)
      - enum: `TIF_UNSPECIFIED`, `TIF_GTC`, `TIF_DAY`, `TIF_IOC`, `TIF_FOK`, `TIF_GTD`
    - `comment` (string) — Order comment

#### `400` — Bad request (missing or invalid account_id)

**Content-Type:** `application/json`

- `error` (object) (required)
  - `type` (string) (required) — Error type code
  - `message` (string) (required) — Human-readable error message
  - `field` (string) — Field name if error is field-specific

#### `401` — Unauthorized (invalid or missing JWT token)

**Content-Type:** `application/json`



#### `403` — Forbidden (account access denied)

**Content-Type:** `application/json`



#### `404` — Account not found

**Content-Type:** `application/json`



#### `500` — Internal server error

**Content-Type:** `application/json`