## Get Order By ID

`client.V1.Orders.GetOrderByID(ctx, orderID, query) (*V1OrderGetOrderByIDResponse, error)`

**get** `/v1/accounts/{account_id}/orders/{order_id}`

Get Order By ID

### Parameters

- `orderID string`

- `query V1OrderGetOrderByIDParams`

  - `AccountID param.Field[int64]`

    Account identifier

### Returns

- `type V1OrderGetOrderByIDResponse struct{…}`

  - `Data Order`

    A trading order with its current state and execution details.

    This is the unified API representation of an order across its lifecycle,
    combining data from execution reports, order status queries, and parent/child tracking.

    - `ID string`

      Engine-assigned unique identifier for this order (UUID).

    - `AccountID int64`

      Account placing the order

    - `ClientOrderID string`

      Client-provided identifier echoed back (FIX tag 11).

    - `CreatedAt Time`

      Timestamp when order was created (UTC)

    - `FilledQuantity string`

      Cumulative filled quantity

    - `InstrumentID string`

      OEMS instrument UUID for the traded instrument.

    - `InstrumentType SecurityType`

      Type of security

      - `const SecurityTypeCommonStock SecurityType = "COMMON_STOCK"`

      - `const SecurityTypePreferredStock SecurityType = "PREFERRED_STOCK"`

      - `const SecurityTypeOption SecurityType = "OPTION"`

      - `const SecurityTypeCash SecurityType = "CASH"`

      - `const SecurityTypeOther SecurityType = "OTHER"`

    - `LeavesQuantity string`

      Remaining unfilled quantity

    - `OrderType OrderType`

      Type of order (MARKET, LIMIT, etc.)

      - `const OrderTypeMarket OrderType = "MARKET"`

      - `const OrderTypeLimit OrderType = "LIMIT"`

      - `const OrderTypeStop OrderType = "STOP"`

      - `const OrderTypeStopLimit OrderType = "STOP_LIMIT"`

      - `const OrderTypeTrailingStop OrderType = "TRAILING_STOP"`

      - `const OrderTypeTrailingStopLimit OrderType = "TRAILING_STOP_LIMIT"`

      - `const OrderTypeOther OrderType = "OTHER"`

    - `Quantity string`

      Total order quantity

    - `Side Side`

      Side of the order (BUY, SELL, SELL_SHORT)

      - `const SideBuy Side = "BUY"`

      - `const SideSell Side = "SELL"`

      - `const SideSellShort Side = "SELL_SHORT"`

      - `const SideOther Side = "OTHER"`

    - `Status OrderStatus`

      Current status of the order

      - `const OrderStatusPendingNew OrderStatus = "PENDING_NEW"`

      - `const OrderStatusNew OrderStatus = "NEW"`

      - `const OrderStatusPartiallyFilled OrderStatus = "PARTIALLY_FILLED"`

      - `const OrderStatusFilled OrderStatus = "FILLED"`

      - `const OrderStatusCanceled OrderStatus = "CANCELED"`

      - `const OrderStatusRejected OrderStatus = "REJECTED"`

      - `const OrderStatusExpired OrderStatus = "EXPIRED"`

      - `const OrderStatusPendingCancel OrderStatus = "PENDING_CANCEL"`

      - `const OrderStatusPendingReplace OrderStatus = "PENDING_REPLACE"`

      - `const OrderStatusReplaced OrderStatus = "REPLACED"`

      - `const OrderStatusDoneForDay OrderStatus = "DONE_FOR_DAY"`

      - `const OrderStatusStopped OrderStatus = "STOPPED"`

      - `const OrderStatusSuspended OrderStatus = "SUSPENDED"`

      - `const OrderStatusCalculated OrderStatus = "CALCULATED"`

      - `const OrderStatusOther OrderStatus = "OTHER"`

    - `Symbol string`

      Trading symbol

    - `TimeInForce TimeInForce`

      Time in force instruction

      - `const TimeInForceDay TimeInForce = "DAY"`

      - `const TimeInForceGoodTillCancel TimeInForce = "GOOD_TILL_CANCEL"`

      - `const TimeInForceImmediateOrCancel TimeInForce = "IMMEDIATE_OR_CANCEL"`

      - `const TimeInForceFillOrKill TimeInForce = "FILL_OR_KILL"`

      - `const TimeInForceGoodTillDate TimeInForce = "GOOD_TILL_DATE"`

      - `const TimeInForceAtTheOpening TimeInForce = "AT_THE_OPENING"`

      - `const TimeInForceAtTheClose TimeInForce = "AT_THE_CLOSE"`

      - `const TimeInForceGoodTillCrossing TimeInForce = "GOOD_TILL_CROSSING"`

      - `const TimeInForceGoodThroughCrossing TimeInForce = "GOOD_THROUGH_CROSSING"`

      - `const TimeInForceAtCrossing TimeInForce = "AT_CROSSING"`

      - `const TimeInForceOther TimeInForce = "OTHER"`

    - `UpdatedAt Time`

      Timestamp of the most recent update (UTC)

    - `Venue string`

      MIC code of the venue where the order is routed

    - `AverageFillPrice string`

      Average fill price across all executions

    - `Details []string`

      Contains execution, rejection or cancellation details, if any

    - `ExpiresAt Time`

      Timestamp when the order will expire (UTC). Present when time_in_force is GOOD_TILL_DATE.

    - `ExtendedHours bool`

      Whether the order is eligible for extended-hours trading.

    - `LimitOffset string`

      Limit offset for trailing stop-limit orders (signed)

    - `LimitPrice string`

      Limit price (for LIMIT and STOP_LIMIT orders)

    - `QueueState QueueState`

      Parent order queue state, present when the order is awaiting release or released.

      - `const QueueStateAwaitingRelease QueueState = "AWAITING_RELEASE"`

      - `const QueueStateReleased QueueState = "RELEASED"`

    - `ReleasesAt Time`

      Scheduled release time for orders awaiting release.

    - `StopPrice string`

      Stop price (for STOP and STOP_LIMIT orders)

    - `TrailingLimitPx string`

      Current trailing limit price computed by the trailing strategy

    - `TrailingOffset string`

      Trailing offset amount for trailing orders

    - `TrailingOffsetType TrailingOffsetType`

      Trailing offset type for trailing orders

      - `const TrailingOffsetTypePrice TrailingOffsetType = "PRICE"`

      - `const TrailingOffsetTypeBps TrailingOffsetType = "BPS"`

    - `TrailingStopPx string`

      Current trailing stop price computed by the trailing strategy

    - `TrailingWatermarkPx string`

      Trailing watermark price for trailing orders

    - `TrailingWatermarkTs Time`

      Trailing watermark timestamp for trailing orders

    - `UnderlyingInstrumentID string`

      OEMS instrument ID of the option's underlying instrument. Populated only
      for OPTIONS orders; `null` for non-options and for options whose underlier
      cannot be resolved from the instrument cache.

### Example

```go
package main

import (
  "context"
  "fmt"

  "github.com/clear-street/clear-street-go"
  "github.com/clear-street/clear-street-go/option"
)

func main() {
  client := clearstreet.NewClient(
    option.WithAPIKey("My API Key"),
  )
  response, err := client.V1.Orders.GetOrderByID(
    context.TODO(),
    "order_id",
    clearstreet.V1OrderGetOrderByIDParams{
      AccountID: 0,
    },
  )
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response)
}
```

#### Response

```json
{
  "data": {
    "account_id": 19816,
    "average_fill_price": "149.95",
    "created_at": "2025-10-31T13:30:00.000000000Z",
    "filled_quantity": "50",
    "id": "my-ref-id-20251001-001",
    "instrument_id": "a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8",
    "instrument_type": "COMMON_STOCK",
    "leaves_quantity": "50",
    "limit_price": "150.00",
    "order_type": "LIMIT",
    "quantity": "100",
    "side": "BUY",
    "status": "PARTIALLY_FILLED",
    "stop_price": null,
    "symbol": "AAPL",
    "time_in_force": "DAY",
    "updated_at": "2025-10-31T13:35:10.000000000Z"
  },
  "error": null,
  "metadata": {
    "request_id": "0c1d2e3f-4a5b-6c7d-8e9f-0a1b2c3d4e5f"
  }
}
```