---
title: "GET /api/v1/orders"
method: GET
path: "/api/v1/orders"
tags: ["User"]
---

# GET /api/v1/orders

`GET /api/v1/orders`

Get single order details

Retrieve details of a specific order by order_id or client_order_id.

## Possible Details Field Values

| Details | Explanation |
|---------|-------------|
| PostOnlyViolation | Order would take liquidity but was marked post-only |
| IOCViolation | Immediate-or-cancel order could not be fully executed |
| PositionUpdateViolation | Order violates position update constraints |
| ReduceOnlyViolation | Reduce-only order would increase position size |
| ClearinghouseSettleViolation | Order conflicts with clearinghouse settlement |
| MaxFillLimitViolation | Order exceeds maximum fill limit |
| DuplicateClientOrderIdViolation | Client order ID already exists |
| OrderPreCancelled | Order was cancelled before execution |
| PlaceMakerOrderViolation | Maker order placement rules violated |
| DeadMansSwitchExpired | Dead man's switch timeout triggered |
| DisallowedSelfTrading | Self-trading is not permitted |
| OrderCancelledByUser | User manually cancelled the order |
| OrderCancelledBySystem | System automatically cancelled the order |
| OrderCancelledBySystemDueToError | System cancelled due to an error condition |

## Query parameters

- `market` string, required
- `account` string, required
- `order_id` string
- `client_order_id` string

## Response `200`

Order details retrieved successfully

- OrderUpdate
  - `details` string, required
  - `order` OrderDto, required
    - `cancellation_reason` string, required
    - `client_order_id` string, required
    - `details` string, required
    - `is_buy` boolean, required
    - `is_reduce_only` boolean, required
    - `is_tpsl` boolean, required
    - `market` string, required
    - `order_direction` string, required
    - `order_id` string, required
    - `order_type` string, required
    - `orig_size` number, double, nullable
    - `parent` string, required
    - `price` number, double, nullable
    - `remaining_size` number, double, nullable
    - `size_delta` number, double, nullable
    - `sl_limit_price` number, double, nullable
    - `sl_trigger_price` number, double, nullable
    - `status` string, required
    - `tp_limit_price` number, double, nullable
    - `tp_trigger_price` number, double, nullable
    - `transaction_version` integer, required
    - `trigger_condition` string, required
    - `unix_ms` integer, required
  - `status` string, required

---

[API](https://skmtc.net/decibel/apis/decibel-trading-api.md) · [All operations](https://skmtc.net/decibel/apis/decibel-trading-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/decibel/decibel-trading-api/versions/37a02083ff59/schema)