# Query order (server ID) Get the order for the given server order ID. Endpoint: GET /v2/orders/{id} Version: 1.0.1 Security: SSO_TOKEN ## Path parameters: - `id` (string, required) The unique ID assigned by the server when your order was placed. Returned in response in the field. Example: "4820276016" ## Response 200 fields (application/json): - `coId` (string, required) Client order ID assigned by the API user. - `type` (string, required) - - - - - - - - (previously quoted) - `timeInForce` (string, required) - - - - - - `side` (string, required) or from the order placer’s perspective and always for the dealt currency. - `currency` (string, required) Dealt currency. - `symbol` (string, required) Base and term currency separated by a slash (for example ). - `size` (number, required) Order amount. - `rateId` (string) Unique identifier for rate. Required for Previously Quoted Orders. - `org` (string) Organization ID in Integral's system. If the order was placed on behalf of another organization, this parameter contains the other organization's ID. - `account` (string) The ID of the account (legal entity) for which the order was placed. Required when placing orders on behalf of another organization. - `price` (number) Order’s limit price, if any. - `priceType` (string) Optional for At Best orders. * * * - `expiryTime` (integer) Expiry time when . In seconds. Max value is one day (86399 seconds). - `clientOrderTime` (string) Time the order was submitted in the format . - `tradeChannel` (string) The app or workflow that originated the order. - `targetStrategy` (string) Algo: The algo or strategy of the order: - - - - - - `originalCoId` (string) The original client order ID of the order to be cancelled or replaced by this request. - `stopPrice` (number) Order’s stop price (if any). - `execFlags` (array) Execution strategy requested with order: - : Stay on bid side - : Mid price - : Stay on offer side - `minQty` (number) Minimum fill size (if any) in dealt currency. - `maxShow` (number) Amount of the order visible to other market participants: - 0 (zero) or undefined: Hidden: Order is not visible to other customers. - Equal to : Display: Full order amount visible to other customers. - Less than : Iceberg: Only the value of visible. - `averagePrice` (number) Average price of all fills so far. For orders and order types with such as at-best orders, this is the filled price. - `cumQty` (number) Total cumulative amount filled so far. - `orderId` (string) Order ID assigned by Integral. - `valueDate` (string) Value date in the format . - `tradeDate` (string) Trade date of fill. - `executionType` (string) - - - - - - `leavesQty` (number) Unfilled amount as of the most recent fill. - `counterparty` (string) Counterparty organization ID. - `counterPartyAccount` (string) Counterparty legal entity ID. - `transactTime` (integer) UTC time of last event on the order in milliseconds. - `userFullName` (string) Fully qualified user name of order submitting user, including namespace and organization ID in the format @.. - `action` (string) - - - - `status` (string) - : Order received. - : Order has been entered and is working according to the order type and specified execution strategy. - : Trade done that does not completely fill the order. - : Trade done that completely fills the order. - : Cancel order request has been received and is in process. - : Order has been canceled. - : Order has been replaced with a new order. - : Price matching has been paused for the order. - : Order has been rejected. - : Order expired. - : Order failed. - `reason` (string) Orders with or , the reason for failure or rejection. indicates a serious error. Stop trading immediately and contact Business Support to resolve the issue. - `customerId` (string) Customer ID on whose behalf the order is placed. - `executionStartTime` (string) Relative time at which the strategy should start execution specified in the format . If not specified, the strategy starts executing immediately. - `executionEndTime` (string) Absolute time in GMT at which the strategy should stop executing. If not specified, the order expires based on the value of its time in force. - `pegPriceType` (string) The rate the order is pegged to: - : Pegged to mid rate. - `pegOffsetValue` (number) The amount in pips that is added to the price of the peg. Can be positive or negative. - `actionOnExpiry` (string) Action taken at the end of the algo’s duration if there is an unfilled amount remaining. If not specified, the order is cancelled at expiration. NoAction, FillAtMarket, Twap - `sliceSize` (number) The fixed size of each slice. - `passiveTime` (integer) Time for which each slice rests in OCX RiskNet. Specified in milliseconds. Overrides . - `passiveTimeFactorPercentage` (number) Determines how long each slice rests in OCX RiskNet, calculated as a percent of the actual slice interval. Required if is not set - `sliceInterval` (integer) Interval between slices in milliseconds. If the interval is fixed, this value is the interval duration. If the interval is randomized, this value is the upper boundary of random values. - `randomizeSliceSizePercentage` (number) The percentage range that the is randomized. - `randomizeSliceIntervalPercentage` (number) The percentage range that the is randomized. - `tobRange` (number) If undefined, the slice size is this percentage of the top-of-book price size. - `customParameters` (object) Collection of parameters that are unique to your organization. The number of parameters, their keynames, and values are defined by you. Contact your Integral Technical Account Manager to enable and configure custom parameters. Your custom parameters are included in API responses and in STP trade download. Custom parameters sent to Integral via API are stored in the database directly. No validation is performed. The maximum size of the property is characters, including all keys, values, and JSON syntax characters. - `customParameters.keyName` (string) The keyname of a custom parameter key/value pair as defined by your organization. Contact your Integral Technical Account Manager to enable and configure custom parameters. - `customParameters.value` (string) The value of a custom parameter key/value pair as defined by your organization. Contact your Integral Technical Account Manager to enable and configure custom parameters.