---
title: "Status Of A Single Order"
method: GET
path: "/iserver/account/order/status/{orderId}"
tags: ["tradingOrders"]
---

# Status Of A Single Order

`GET /iserver/account/order/status/{orderId}`

Retrieve the status of a single order. Only displays orders from the current brokerage session. If orders executed on a previous day or session, queries will 503 error.

## Path parameters

- `orderId` string, required

## Response `200`

order status

- TradingOrdersGetOrderStatusResponse200 — Object containing information about the status of an order ticket.
  - `sub_type` string, nullable — Internal use only.
  - `request_id` string — Internal use only. IB-assigned identifier for the status request.
  - `server_id` string — IB-assigned meta-identifier used to associate rejected and resubmitted orders following Server Prompts.
  - `order_id` integer — The IB-assigned order identifier of the order, as provided in the request path.
  - `conidex` string — Contract ID and routing destination in format 123456@EXCHANGE.
  - `conid` integer — Contract ID of the order's instrument.
  - `symbol` string — Symbol of the order ticket's instrument.
  - `side` 'BUY' | 'SELL' — Side of the order ticket.
  - `contract_description_1` string — Human-readable description of the order's instrument.
  - `listing_exchange` string — Primary listing exchange of the order ticket's instrument.
  - `option_acct` string — Internal use only.
  - `company_name` string — Name of the company or asset associated with the instrument.
  - `size` string — Remaining unfilled size of the order ticket. Will reflect 0.0 if order is filled in full, cancelled, or otherwise resolved and no longer working.
  - `total_size` string — The total size of the order ticket.
  - `currency` string — The currency in which the instrument trades and executions are conducted.
  - `account` string — The account receiving executions against this order ticket.
  - `order_type` string — The order's IB order type.
  - `cum_fill` string — Cumulative filled quantity of the instrument against the order ticket.
  - `order_status` 'Inactive' | 'PendingSubmit' | 'PreSubmitted' | 'Submitted' | 'Filled' | 'PendingCancel' | 'Cancelled' | 'WarnState' — Status of the order ticket.
  - `order_ccp_status` string — IB internal order status.
  - `order_status_description` string — Human-readable rendering of the order's status meant for presentation in UI.
  - `tif` 'DAY' | 'IOC' | 'GTC' | 'OPG' | 'PAX' — Time in force of the order ticket.
  - `fgColor` string — Internal use. IB's UI foreground color in hex.
  - `bgColor` string — Internal use. IB's UI background color in hex.
  - `order_not_editable` boolean — Indicates whether the order ticket can be modified.
  - `editable_fields` string — Indicates which fields of the order ticket can be modified currently.
  - `cannot_cancel_order` boolean — Indicates whether the order ticket can be cancelled.
  - `deactivate_order` boolean — Indicates whether the order ticket can be deactivated.
  - `sec_type` 'STK' | 'OPT' | 'FUT' | 'FOP' | 'CASH' | 'CRYPTO' | 'BOND' | 'WAR' | 'FUND' — IB asset class identifier.
  - `available_chart_periods` string — Internal use. Indicates chart periods available for the instrument.
  - `order_description` string — Human-readable description of the status or current result of the order ticket, meant for UI presentation.
  - `order_description_with_contract` string — Human-readable description of the status or current result of the order ticket, meant for UI presentation. Includes instrument name.
  - `alert_active` '0' | '1' — Indicates that an alert is active for the order ticket.
  - `child_order_type` '0' | 'A' | 'B' — Indicates if the order ticket is hedged, and if so, in what way. 0 = No hedge, A = Attached child hedge order, B = Beta/portfolio hedge
  - `order_clearing_account` string — The IB account to which the order ticket clears.
  - `size_and_fills` string — A string reflecting the cumulative fills and total size of the order.
  - `exit_strategy_display_price` string — Internal use. The UI-displayed price associated with a Client Portal exist strategy.
  - `exit_strategy_chart_description` string — Internal use. A string describing an active Client Portal exit strategy, or the result of its execution.
  - `average_price` string — Average price of fills against the order, if any.
  - `exit_strategy_tool_availability` string — Internal use. Indicates the availability of Client Portal exit strategy tool for the order.
  - `allowed_duplicate_opposite` boolean — Indicates whether an identical order on the opposite side can be placed.
  - `order_time` string — Time of the order's submission in format YYMMDDhhmmss.

## Other responses

- `400` — Missing, empty, non-numeric, or out-of-range parameter. The `error` field is always prefixed with `Bad Request:`.
- `401` — Missing, invalid, or unparseable Authorization token.
- `500` — internal server error, returned when incoming request cannot be processed. It can sometimes include subset of bad requests. For example, wrong accountId passed and it can only be detected later in handling request. Error contains reason of the problem.
- `503` — service is unavailable. For example if request takes more than 10s due to some internal service unavailability, request aborted and this status returned

---

[API](https://skmtc.net/interactivebrokers/apis/api-reference.md) · [All operations](https://skmtc.net/interactivebrokers/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interactivebrokers/api-reference/revisions/67f9f562c2c6/schema)