---
title: "Get order details"
method: GET
path: "/v0/orders/{id}"
tags: ["Orders"]
---

# Get order details

`GET /v0/orders/{id}`

## Path parameters

- `id` string, required

## Response `200`

Order details

- MarketApiOrderResponse
  - `object` 'order', required
  - `id` string, required
  - `side` 'buy' | 'sell', required
  - `status` 'open' | 'filled' | 'cancelled' | 'rejected', required
  - `instance_type` string, required
  - `quantity` integer, required
  - `start_at` string, date-time, required — An ISO 8601 datetime string
  - `end_at` string, date-time, required — An ISO 8601 datetime string
  - `price` integer, required — Price in cents
  - `flags` MarketApiOrderFlags, required — Configure more fine grained order behavior.
    - `ioc` boolean — If true, the order will be automatically cancelled if it doesn't immediately fill when being placed.
    - `post_only` boolean — If true, places the order straight into the book without trying to match against existing orders.
    - `market` boolean — If true, ignores the set limit price and matches any price that is available.
    - `prorate` boolean — If the order start time should be automatically changed to "now" once start time < "now", proportionally changing it's limit price to reflect it's shorter duration.
  - `executed` boolean, required
  - `executed_at` string, date-time — An ISO 8601 datetime string
  - `execution_price` integer, nullable
  - `cancelled` boolean, required
  - `cancelled_at` string, date-time — An ISO 8601 datetime string
  - `colocate_with` MarketApiContractId[]
  - `created_at` string, date-time, required — An ISO 8601 datetime string
  - `rejected` boolean, required
  - `rejected_reason` string, nullable
  - `cluster` string
  - `duration` integer, required — Unix timestamp.

## Other responses

- `401` — Unauthorized - missing or invalid authentication token
- `403` — Forbidden - user not authorized to view this order
- `404` — Order not found
- `500` — Internal server error

## Changes

- **2026-05-15** `b819ba3108b3` — 12 breaking, 4 info
  - removed the required property `details` from the response with the `401` status
  - removed the required property `details` from the response with the `403` status
  - removed the required property `details` from the response with the `404` status
  - removed the required property `details` from the response with the `500` status
  - …12 more
- **2026-02-11** `73ad90aa5d19` — 1 warning, 2 info
  - changed the pattern of the `path` request parameter `id` from `"ordr"_[0-9a-zA-Z]+` to `ordr_[0-9a-zA-Z_-]{1,21}`
  - the `colocate_with/items/` response's property pattern was changed from `"cont"_[0-9a-zA-Z]+` to `cont_[0-9a-zA-Z_-]{1,21}` for the status `200`
  - the `id` response's property pattern was changed from `"ordr"_[0-9a-zA-Z]+` to `ordr_[0-9a-zA-Z_-]{1,21}` for the status `200`
- **2025-12-09** `00ce4132845e` — 1 breaking, 1 info
  - added `#/components/schemas/market-api_ZoneName` to the `cluster` response property `oneOf` list for the response status `200`
  - removed `#/components/schemas/market-api_ClusterName` from the `cluster` response property `oneOf` list for the response status `200`

[Change history](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/changes/v0/orders/:id/get.md)

---

[API](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation.md) · [All operations](https://skmtc.dev/sfcompute/apis/san-francisco-compute-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sfcompute/san-francisco-compute-documentation/revisions/93dd7661e9bb/schema)