---
title: "List orders"
method: GET
path: "/accounts/{account_id}/orders"
tags: ["Orders"]
---

# List orders

`GET /accounts/{account_id}/orders`

List orders for a given account for the current trading day, filtered on the given query parameters.

## Path parameters

- `account_id` string, required — Account ID for the account.

## Query parameters

- `from` integer — Milliseconds since epoch.
- `to` integer — Milliseconds since epoch.
- `page_size` integer — Number of orders to return per page.
- `page_token` string — Cursor for the page to return.

## Response `200`

Successful response

- object
  - `data` Order[], required
    - `created_at` integer, required — Milliseconds since epoch.
    - `updated_at` integer, required — Milliseconds since epoch.
    - `order_id` string, required — Unique order ID assigned by us.
    - `reference_id` string — An ID that you provide.
    - `version` integer, required — A monotonically increasing number indicating the version of this order. A higher number indicates a more recent version of the order.
    - `account_id` string, required — Account ID for the account.
    - `account_number` string, required — Account number for the account.
    - `state` 'open' | 'rejected' | 'closed', required — Simplified order state, which is inferred from `OrderStatus`. Makes it easier to determine whether an order can be executed against. - `open`: Order *can* potentially be executed against. - `rejected`: Order *cannot* be executed against because it was rejected. This is a terminal state. - `closed`: Order *cannot* be executed against. This is a terminal state.
    - `status` 'new' | 'partially-filled' | 'filled' | 'canceled' | 'replaced' | 'pending-cancel' | 'stopped' | 'rejected' | 'suspended' | 'pending-new' | 'calculated' | 'expired' | 'accepted-for-bidding' | 'pending-replace' | 'done-for-day', required — Granular order status using [standard values come FIX tag 39](https://www.fixtrading.org/online-specification/order-state-changes).
    - `symbol` string, required
    - `order_type` 'limit' | 'market' | 'stop' | 'stop-limit', required — The type of order, can be one of the following: - `limit`: A limit order will execute at-or-better than the limit price you specify - `market`: An order that will execute at the prevailing market prices - `stop`: A stop order will result in a market order when the market price reaches the specified stop price - `stop-limit`: A stop limit order will result in a limit order when the market price reaches the specified stop price
    - `side` 'buy' | 'sell' | 'sell-short', required — Buy, sell, sell-short indicator.
    - `quantity` string, required — String representation of quantity.
    - `price` string — String representation of a price.
    - `stop_price` string — String representation of a price.
    - `time_in_force` 'day' | 'ioc' | 'day-plus' | 'at-open' | 'at-close', required — The lifecycle enforcement of this order. - `day`: The order will exist for the duration of the current trading session - `ioc`: The order will immediately be executed or cancelled - `day-plus`: The order will exist only for the duration the current trading session plus extended hours, if applicable - `at-open`: The order will exist only for the opening auction of the next session - `at-close`: The order will exist only for the closing auction of the current session
    - `average_price` number, double — Calculated average price of all fills on this order.
    - `filled_quantity` string, required — String representation of quantity.
    - `order_update_reason` 'place' | 'modify' | 'cancel' | 'execution-report' | 'cancel-reject' | 'reject'
    - `text` string — Free form text typically contains reasons for a reject.
    - `strategy` union
      - SorStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `start_at` integer — Milliseconds since epoch.
        - `end_at` integer — Milliseconds since epoch.
        - `urgency` 'super-passive' | 'passive' | 'moderate' | 'aggressive' | 'super-aggressive' — The urgency associated with the execution strategy.
      - VwapStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `start_at` integer — Milliseconds since epoch.
        - `end_at` integer — Milliseconds since epoch.
        - `urgency` 'super-passive' | 'passive' | 'moderate' | 'aggressive' | 'super-aggressive' — The urgency associated with the execution strategy.
        - `min_percent` integer — The minimum percentage of market volume. Must be an integer between 0 and 100 (inclusive).
        - `max_percent` integer — The maximum percentage of market volume. Must be an integer between 0 and 50 (inclusive).
      - TwapStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `start_at` integer — Milliseconds since epoch.
        - `end_at` integer — Milliseconds since epoch.
        - `urgency` 'super-passive' | 'passive' | 'moderate' | 'aggressive' | 'super-aggressive' — The urgency associated with the execution strategy.
        - `min_percent` integer — The minimum percentage of market volume. Must be an integer between 0 and 100 (inclusive).
        - `max_percent` integer — The maximum percentage of market volume. Must be an integer between 0 and 50 (inclusive).
      - ApStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `start_at` integer — Milliseconds since epoch.
        - `end_at` integer — Milliseconds since epoch.
        - `urgency` 'super-passive' | 'passive' | 'moderate' | 'aggressive' | 'super-aggressive' — The urgency associated with the execution strategy.
        - `min_percent` integer — The minimum percentage of market volume. Must be an integer between 0 and 100 (inclusive).
        - `max_percent` integer — The maximum percentage of market volume. Must be an integer between 0 and 100 (inclusive).
      - PovStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `start_at` integer — Milliseconds since epoch.
        - `end_at` integer — Milliseconds since epoch.
        - `urgency` 'super-passive' | 'passive' | 'moderate' | 'aggressive' | 'super-aggressive' — The urgency associated with the execution strategy.
        - `target_percent` integer, required — The target percentage of market volume. Must be an integer between 0 and 100 (inclusive).
      - DarkStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `start_at` integer — Milliseconds since epoch.
        - `end_at` integer — Milliseconds since epoch.
        - `urgency` 'super-passive' | 'passive' | 'moderate' | 'aggressive' | 'super-aggressive' — The urgency associated with the execution strategy.
        - `max_percent` integer — The maximum percentage of market volume. Must be an integer between 0 and 100 (inclusive).
      - DmaStrategy
        - `type` 'sor' | 'dark' | 'ap' | 'pov' | 'twap' | 'vwap' | 'dma', required — Strategy type used for execution, can be one of below. - `sor`: Smart order router (default) - `dark`: Dark pool - `ap`: Arrival price - `pov`: Percentage of volume - `twap`: Time weighted average price - `vwap`: Volume weighted average price - `dma`: Direct market access For more information on these strategies, please refer to our [documentation](https://docs.clearstreet.io/studio/docs/execution-strategies).
        - `destination` 'arcx' | 'bats' | 'baty' | 'edga' | 'edgx' | 'eprl' | 'iexg' | 'memx' | 'xase' | 'xbos' | 'xcis' | 'xnms' | 'xnys', required — Order Destination. <table><thead> <tr> <th>MIC</th> <th>Exchange</th> </tr></thead> <tbody> <tr> <td>ARCX</td> <td>NYSE ARCA</td> </tr> <tr> <td>BATS</td> <td>BATS Exchange</td> </tr> <tr> <td>BATY</td> <td>BATS Y Exchange</td> </tr> <tr> <td>EDGA</td> <td>EDGA Exchange</td> </tr> <tr> <td>EDGX</td> <td>EDGX Exchange</td> </tr> <tr> <td>EPRL</td> <td>MIAX Pearl Equities</td> </tr> <tr> <td>IEXG</td> <td>Investors' Exchange</td> </tr> <tr> <td>MEMX</td> <td>Members' Exchange</td> </tr> <tr> <td>XASE</td> <td>NYSE American</td> </tr> <tr> <td>XBOS</td> <td>NASDAQ BX Exchange</td> </tr> <tr> <td>XCIS</td> <td>NYSE National</td> </tr> <tr> <td>XNMS</td> <td>NASDAQ/NMS (Global Market)</td> </tr> <tr> <td>XNYS</td> <td>New York Stock Exchange</td> </tr> </tbody></table>
    - `running_position` string, required — String representation of quantity.
    - `open_close_indicator` 'open' | 'close'
  - `next_page_token` string — Cursor for the next page of results.

## Other responses

- `default` — Error response

---

[API](https://skmtc.net/clear-street/apis/common-api-models.md) · [All operations](https://skmtc.net/clear-street/apis/common-api-models/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clear-street/common-api-models/revisions/05b4df42c056/schema)