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

# Get Order Status

Fetches real-time status and delivery fulfillment information for a specific order.

Use this endpoint to render customer-facing tracking views, success dashboards, and invoice receipts.

### Authorizations

<ParamField header="X-Shop-API-Key" type="string" required>
  Your Publishable Key (`pk_live_...` or `pk_test_...`) generated from the Developer settings in your dashboard.
</ParamField>

### Path Parameters

<ParamField path="shopId" type="string" required>
  The unique UUID of the shop.
</ParamField>

<ParamField path="orderId" type="number" required>
  The unique ID of the order.
</ParamField>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "status": "success",
    "data": {
      "id": 501,
      "reference": "ORD-501-ABCDE",
      "customerName": "Jane Doe",
      "orderStatus": "pending",
      "paymentStatus": "pending",
      "totalPriceKobo": 1250000,
      "shippingFeeKobo": 150000,
      "createdAt": "2026-06-19T14:30:00.000Z",
      "items": [
        {
          "productName": "Air Max Sneaker",
          "quantity": 1,
          "variantName": "Red / 42"
        }
      ]
    }
  }
  ```

  ```json 400 Bad Request theme={null}
  {
    "message": "FORM_VALIDATION_ERROR",
    "code": 400,
    "validationErrors": [
      {
        "path": [
          "orderId"
        ],
        "message": "Order not found"
      }
    ]
  }
  ```
</ResponseExample>