---
title: "Returns an order by their id"
method: GET
path: "/v1/order/{id}"
tags: ["Order"]
---

# Returns an order by their id

`GET /v1/order/{id}`

## Path parameters

- `id` string, required

## Response `200`

- OrderDto
  - `availableQuantity` string, decimal, required — Remaining quantity (if modified or reduced) in native units expressed as a decimal (precision: 9)
  - `clientOrderId` string — A subaccount scoped unique client-generated order id (either a UUID or alphanumeric string up to 32 characters)
  - `close` boolean, required — Order closes the entire current position
  - `createdAt` integer, required — Order creation timestamp (ms since Unix Epoch)
  - `expiresAt` integer, required — Order expiry timestamp (seconds since Unix Epoch)
  - `filled` string, decimal, required — Filled amount in native units expressed as a decimal (precision: 9)
  - `groupContingencyType` 0 | 1
  - `groupId` string, uuid — Id of the group this order belongs to
  - `id` string, uuid, required — Id representing the order
  - `postOnly` boolean — Only add order if it does not immediately fill (limit only)
  - `price` string, decimal, required — Limit price in native units expressed as a decimal, zero if market order (precision: 9)
  - `productId` string, uuid, required — Id of product this order was placed against
  - `quantity` string, decimal, required — Original quantity (as per order submission) in native units expressed as a decimal (precision: 9)
  - `reduceOnly` boolean, required — Indicates if the order is reduce only
  - `rejectedReason` 'AccountSuspended' | 'CausesImmediateLiquidation' | 'DuplicateSameSideOco' | 'ExchangeSuspended' | 'ImmediateMatchPostOnly' | 'InstrumentOpenValueCapExceeded' | 'InsufficientBalance' | 'Liquidation' | 'MarketOrderReachedMaxSlippage' | 'OcoFilled' | 'OrderIncreasesPosition' | 'RiskLimitExceeded' | 'SignerRevoked' | 'TriggerCanceled' | 'QuantityAboveMaximum' | 'UnfilledFillOrKill' | 'UnfilledImmediateOrCancel' | 'UnfilledMarketOrder' | 'MakerCanceledByTaker' | 'CloseOrder' — Reason the order was rejected, if applicable
  - `sender` string, hex, required — Account or linked signer address that placed this order
  - `side` 0 | 1, required
  - `status` 'NEW' | 'PENDING' | 'FILLED_PARTIAL' | 'FILLED' | 'REJECTED' | 'CANCELED' | 'EXPIRED', required — Status of the order
  - `stopPrice` string, decimal, required — Stop price expressed as a decimal (zero if not a stop order, precision: 9)
  - `stopPriceType` 0 | 1 — Type of stop price (stop orders only)
  - `stopType` 0 | 1
  - `subaccountId` string, uuid, required — Id of the subaccount associated to order
  - `timeInForce` 'GTD' | 'IOC' | 'FOK' — How long an order will remain until executed/expired (required if limit)
  - `triggered` 'NOT_TRIGGERED' | 'TRIGGERED' | 'STOP_ORDER_TRIGGERED' | 'OCO_ORDER_TRIGGERED' | 'OTO_ORDER_TRIGGERED', required — Indicates order trigger conditions which have or have not been met: NOT_TRIGGERED (waiting for stop/OTO condition), TRIGGERED (immediately active), STOP_ORDER_TRIGGERED (stop price condition met), OCO_ORDER_TRIGGERED (canceled because OCO sibling filled), OTO_ORDER_TRIGGERED (activated by OTO parent filling)
  - `type` 'MARKET' | 'LIMIT', required — Trade order type e.g. MARKET or LIMIT
  - `updatedAt` integer, required — Order last updated timestamp (ms since Unix Epoch)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Entity
- `429` — Too Many Requests
- `500` — Internal Server Error

---

[API](https://skmtc.net/ethereal/apis/ethereal-exchange-api.md) · [All operations](https://skmtc.net/ethereal/apis/ethereal-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ethereal/ethereal-exchange-api/revisions/6e6f8dad92bf/schema)