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

# Get order

`GET /accounts/{account_id}/orders/{order_id}`

## Request

- Base URL: `https://api.clearstreet.io/studio/v2`
- URL: `https://api.clearstreet.io/studio/v2/accounts/{account_id}/orders/{order_id}`
- Auth: HTTP bearer

Get an order that was previously created.

## Path parameters

- `account_id` string, required: Account ID for the account.
- `order_id` string, required: Unique order ID assigned by us.

## Response `200`

The order associated with the given `order_id`.

- object
  - `order` 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'

## Changes

- **2026-05-29** `05b4df42c056`: 1 breaking, 2 warning
  - the `order/open_close_indicator` response's property type changed from no type to `string` for status `200`
  - added the new `close` enum value to the `order/open_close_indicator` response property for the response status `200`
  - added the new `open` enum value to the `order/open_close_indicator` response property for the response status `200`
- **2026-05-29** `9deaa48a0d68`: 1 breaking, 2 info
  - the `order/open_close_indicator` response's property type changed from `string` to no type for status `200`
  - removed the `close` enum value from the `order/open_close_indicator` response property for the response status `200`
  - removed the `open` enum value from the `order/open_close_indicator` response property for the response status `200`
- **2026-03-03** `05b4df42c056`: 1 warning, 1 info
  - added the new `reject` enum value to the `order/order_update_reason` response property for the response status `200`
  - added the optional property `order/open_close_indicator` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/clear-street/apis/common-api-models/changes/accounts/:account_id/orders/:order_id/get.md)

---

[API](https://skmtc.dev/clear-street/apis/common-api-models.md) - [All operations](https://skmtc.dev/clear-street/apis/common-api-models/llms.txt) - [OpenAPI document](https://skmtc.dev/clear-street/apis/common-api-models/revisions/585e71254e37?raw)