> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trusset.org/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Order
> Retrieve one order with its book and its fills
Returns a single order, the book it sits on, and every trade it took part in on either side. Resolves only if the order's book is an external securities book your instance owns or has imported.
`expiresAt` is the deadline from the signed order. Past it the signature can no longer settle, even though the row may still read `OPEN` until a sweeper or an incoming order retires it.
## Path Parameters
The order's `orderId`.
## Response Fields
Internal row ID.
Public order ID.
Book the order sits on.
Instance that submitted the order.
Trader's wallet, lower-cased.
Trading account, or `null`.
`BUY` or `SELL`.
`LIMIT`.
Limit price in order book units.
Original quantity in order book units.
Quantity filled so far.
Quantity still working.
`OPEN`, `PARTIALLY_FILLED`, `FILLED`, `CANCELLED`, `EXPIRED` or `REJECTED`.
`GTC`, `IOC` or `FOK`.
Whether the order refused to take.
Self-trade policy in force.
Reservation backing the order, or `null` once released.
Why the order closed, or `null`. Beyond `USER_CANCELLED` this can name a chain-side retirement: cancelled on chain, nonce invalidated, or filled on chain.
Deadline from the signed order, as ISO 8601.
`null` on this venue.
ISO 8601 timestamp.
ISO 8601 timestamp.
The full order book record. See [Get Order Book](/endpoints/external-securities-trading/get-order-book).
Trades where this order was the resting side.
Trades where this order was the aggressing side.
The signed struct behind the order, meaning its hash, signature, nonce and salt, is not returned here. Keep the `orderHash` from [Submit Order](/endpoints/external-securities-trading/submit-order) if you need to reconcile against the chain.
```bash cURL theme={null}
curl "https://api.trusset.org/orderbooks/external-securities/api/orders/c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320" \
-H "X-API-Key: trusset_your_key_here"
```
```typescript TypeScript theme={null}
const res = await fetch(
`https://api.trusset.org/orderbooks/external-securities/api/orders/${orderId}`,
{ headers: { 'X-API-Key': 'trusset_your_key_here' } }
);
const { data } = await res.json();
console.log(data.status, data.remainingQuantity, data.expiresAt);
```
```json Response theme={null}
{
"success": true,
"data": {
"id": "clx_order_812",
"orderId": "c81f4a9e-2d70-4bb3-9f16-08a5c7d1e320",
"orderBookId": "clx_ob_extsec_001",
"instanceId": "inst_abc123",
"userAddress": "0xabc7f1093d5e26b804a1c3f78de025916b47c0d3",
"accountId": "clx_acct_12",
"side": "BUY",
"orderType": "LIMIT",
"price": "104200000",
"quantity": "10000000",
"filledQuantity": "4000000",
"remainingQuantity": "6000000",
"status": "PARTIALLY_FILLED",
"timeInForce": "GTC",
"postOnly": false,
"selfTradePreventionMode": "NONE",
"lockId": "clx_lock_204",
"cancelReason": null,
"expiresAt": "2025-06-22T12:00:00.000Z",
"auctionId": null,
"createdAt": "2025-06-15T12:00:00.000Z",
"updatedAt": "2025-06-15T12:03:00.000Z",
"orderBook": { "id": "clx_ob_extsec_001", "symbol": "HELG", "status": "ACTIVE" },
"makerTrades": [],
"takerTrades": [
{
"tradeId": "5b3c19e0-7a42-4d86-91f5-2c0e8d47b613",
"price": "104200000",
"quantity": "4000000",
"makerFee": "0",
"takerFee": "4000",
"side": "BUY",
"origin": "CLOB",
"settlementStatus": "CONFIRMED",
"createdAt": "2025-06-15T12:03:00.000Z"
}
]
}
}
```
## Error Codes
| Code | HTTP | Cause |
| --------------------- | ----- | ---------------------------------------------------------------------- |
| `ORDER_NOT_FOUND` | `404` | No order with that ID, or its book is not reachable from your instance |
| `SERVICE_NOT_ENABLED` | `403` | The Trading service is not enabled on this instance |