> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bayse.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Get order

> Get details of a specific order

## Authentication

Read authentication required — `X-Public-Key` header.

## Path parameters

<ParamField path="orderId" type="string" required>
  UUID of the order.
</ParamField>

## Example request

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://relay.bayse.markets/v1/pm/orders/f6a7b8c9-d0e1-2345-fabc-678901234567" \
    -H "X-Public-Key: pk_live_abcdef123456"
  ```

  ```javascript Node.js theme={null}
  const orderId = 'f6a7b8c9-d0e1-2345-fabc-678901234567';
  const response = await fetch(
    `https://relay.bayse.markets/v1/pm/orders/${orderId}`,
    { headers: { 'X-Public-Key': 'pk_live_abcdef123456' } }
  );
  const order = await response.json();
  ```

  ```python Python theme={null}
  import requests

  order_id = 'f6a7b8c9-d0e1-2345-fabc-678901234567'
  resp = requests.get(
      f'https://relay.bayse.markets/v1/pm/orders/{order_id}',
      headers={'X-Public-Key': 'pk_live_abcdef123456'},
  )
  order = resp.json()
  ```

  ```go Go theme={null}
  req, _ := http.NewRequest(
      "GET",
      "https://relay.bayse.markets/v1/pm/orders/f6a7b8c9-d0e1-2345-fabc-678901234567",
      nil,
  )
  req.Header.Set("X-Public-Key", "pk_live_abcdef123456")
  resp, _ := http.DefaultClient.Do(req)
  ```
</CodeGroup>

## Response

Returns a single order object. See [Place order](/api-reference/pm/place-order) for the full field reference.

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "id": "f6a7b8c9-d0e1-2345-fabc-678901234567",
    "marketId": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
    "outcome": "YES",
    "side": "BUY",
    "orderType": "LIMIT",
    "stpMode": "SKIP",
    "status": "partial_filled",
    "amount": 100,
    "price": 0.70,
    "size": 100,
    "filledSize": 45,
    "remainingSize": 55,
    "avgFillPrice": 0.70,
    "fee": 0.90,
    "currency": "USD",
    "createdAt": "2026-02-17T12:00:00Z",
    "updatedAt": "2026-02-17T12:03:00Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "error": "not_found",
    "message": "Order not found",
    "statusCode": 404
  }
  ```
</ResponseExample>