> For the complete documentation index, see [llms.txt](https://docs.pangolin.exchange/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.pangolin.exchange/pangoperps/trading-api/order-management/get-order-by-order-id.md).

# Get Order by Order ID

Retrieve the details and execution state of one order by its API-assigned order ID.

### Endpoint

**GET /v1/order/{order\_id}**

Mainnet: `GET https://api.orderly.org/v1/order/{order_id}`

Testnet: `GET https://testnet-api.orderly.org/v1/order/{order_id}`

Rate limit: 10 requests per second. Returns the details for one order. The request is signed and does not have a body.

### Authentication headers

* orderly-timestamp — signed-request timestamp in milliseconds.
* orderly-account-id — PangoPerps account ID.
* orderly-key — public API key.
* orderly-signature — request signature.

### Path parameter

| Parameter | Type   | Required | Description                                                                         |
| --------- | ------ | -------- | ----------------------------------------------------------------------------------- |
| order\_id | string | Yes      | ID assigned to the order. Replace the path placeholder with the requested order ID. |

### Example request

```bash
curl --request GET \
  --url 'https://api.orderly.org/v1/order/123456789' \
  --header 'orderly-account-id: <account-id>' \
  --header 'orderly-key: <public-api-key>' \
  --header 'orderly-signature: <signature>' \
  --header 'orderly-timestamp: <timestamp-in-ms>'
```

### Successful response

HTTP 200 returns success, an order object, and the server timestamp. The order object can include order and client IDs, market, type, side, price, quantity and amount, visible quantity, execution totals and average price, status, fees, realized PnL, reduce-only setting, order tag, margin mode, and creation/update times.

```json
{
  "success": true,
  "data": {
    "order_id": 123456789,
    "user_id": 98765,
    "price": 3450.5,
    "type": "LIMIT",
    "quantity": 0.25,
    "amount": 862.625,
    "total_executed_quantity": 0.25,
    "visible_quantity": 0.25,
    "symbol": "PERP_ETH_USDC",
    "side": "BUY",
    "status": "FILLED",
    "total_fee": 0.25,
    "fee_asset": "USDC",
    "client_order_id": "pango-demo-001",
    "average_executed_price": 3450.5,
    "created_time": 1702989100000,
    "updated_time": 1702989200000,
    "realized_pnl": 0,
    "executed_quantity": 0.25,
    "visible": 0.25,
    "executed": 0.25,
    "reduce_only": false,
    "order_tag": "enum:pangoperps:example",
    "margin_mode": "CROSS"
  },
  "timestamp": 1702989203989
}
```
