Get Order By ID

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

Get Order By ID

Path ParametersExpand Collapse

account_id: number

order_id: string

ReturnsExpand Collapse

data: Order { id, account_id, client_order_id, 29 more }

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).

account_id: number

Account placing the order

formatint64

client_order_id: string

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

created_at: string

Timestamp when order was created (UTC)

formatdate-time

filled_quantity: string

Cumulative filled quantity

instrument_id: string

OEMS instrument UUID for the traded instrument.

formatuuid

instrument_type: SecurityType

Type of security

One of the following:

"COMMON_STOCK"

"PREFERRED_STOCK"

"OPTION"

"CASH"

"OTHER"

leaves_quantity: string

Remaining unfilled quantity

order_type: OrderType

Type of order (MARKET, LIMIT, etc.)

One of the following:

"MARKET"

"LIMIT"

"STOP"

"STOP_LIMIT"

"TRAILING_STOP"

"TRAILING_STOP_LIMIT"

"OTHER"

quantity: string

Total order quantity

side: Side

Side of the order (BUY, SELL, SELL_SHORT)

One of the following:

"BUY"

"SELL"

"SELL_SHORT"

"OTHER"

status: OrderStatus

Current status of the order

One of the following:

"PENDING_NEW"

"NEW"

"PARTIALLY_FILLED"

"FILLED"

"CANCELED"

"REJECTED"

"EXPIRED"

"PENDING_CANCEL"

"PENDING_REPLACE"

"REPLACED"

"DONE_FOR_DAY"

"STOPPED"

"SUSPENDED"

"CALCULATED"

"OTHER"

symbol: string

Trading symbol

time_in_force: TimeInForce

Time in force instruction

One of the following:

"DAY"

"GOOD_TILL_CANCEL"

"IMMEDIATE_OR_CANCEL"

"FILL_OR_KILL"

"GOOD_TILL_DATE"

"AT_THE_OPENING"

"AT_THE_CLOSE"

"GOOD_TILL_CROSSING"

"GOOD_THROUGH_CROSSING"

"AT_CROSSING"

"OTHER"

updated_at: string

Timestamp of the most recent update (UTC)

formatdate-time

venue: string

MIC code of the venue where the order is routed

average_fill_price: optional string

Average fill price across all executions

details: optional array of string

Contains execution, rejection or cancellation details, if any

expires_at: optional string

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

formatdate-time

extended_hours: optional boolean

Whether the order is eligible for extended-hours trading.

limit_offset: optional string

Limit offset for trailing stop-limit orders (signed)

limit_price: optional string

Limit price (for LIMIT and STOP_LIMIT orders)

queue_state: optional QueueState

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

One of the following:

"AWAITING_RELEASE"

"RELEASED"

releases_at: optional string

Scheduled release time for orders awaiting release.

formatdate-time

stop_price: optional string

Stop price (for STOP and STOP_LIMIT orders)

trailing_limit_px: optional string

Current trailing limit price computed by the trailing strategy

trailing_offset: optional string

Trailing offset amount for trailing orders

trailing_offset_type: optional TrailingOffsetType

Trailing offset type for trailing orders

One of the following:

"PRICE"

"BPS"

trailing_stop_px: optional string

Current trailing stop price computed by the trailing strategy

trailing_watermark_px: optional string

Trailing watermark price for trailing orders

trailing_watermark_ts: optional string

Trailing watermark timestamp for trailing orders

formatdate-time

underlying_instrument_id: optional 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.

formatuuid

Get Order By ID

curl https://api.clearstreet.com/v1/accounts/$ACCOUNT_ID/orders/$ORDER_ID \
    -H "Authorization: Bearer $API_KEY"

{
  "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"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}

{
  "error": {
    "code": 404,
    "message": "Order 97dfdcfe503f425c8367ca10928e2499 not found for account 100001"
  },
  "metadata": {
    "request_id": "efbd46f4-4bfc-455b-bae0-ee13f84360ba"
  }
}

Returns Examples

{
  "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"
  }
}

{
  "error": {
    "code": 403,
    "message": "The caller does not have permission to execute the specified operation"
  },
  "metadata": {
    "request_id": "5518f0c6-58ff-4b4a-81a5-701556d41206"
  }
}

{
  "error": {
    "code": 404,
    "message": "Order 97dfdcfe503f425c8367ca10928e2499 not found for account 100001"
  },
  "metadata": {
    "request_id": "efbd46f4-4bfc-455b-bae0-ee13f84360ba"
  }
}