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

# Get Orders Count

> Retrieve the count of orders by status for a specific store, providing a quick overview of active and completed order volumes.

This endpoint provides a summary count of orders grouped by their status, giving you immediate visibility into order volume and distribution. This is particularly useful for dashboard displays and operational monitoring.

<Info>
  Use this endpoint to quickly assess store workload and monitor business performance without retrieving detailed order data.
</Info>

### Query Parameters

<ParamField query="store_id" type="string" required>
  The unique identifier of the store to get order counts for
</ParamField>

### Response

<ResponseField name="order_counts" type="object">
  Object containing counts for different order statuses

  <Expandable title="Count Fields">
    <ResponseField name="active" type="number">
      Total number of active orders (incoming, accepted, preparing, ready, etc.)
    </ResponseField>

    <ResponseField name="completed" type="number">
      Total number of completed/delivered orders
    </ResponseField>
  </Expandable>
</ResponseField>

### Response Example

```json theme={null}
{
  "active": 123,
  "completed": 1
}
```

## Use Cases

### Dashboard Widgets

Create real-time dashboard displays showing:

* Current active order volume
* Completed orders for the day/period
* Order processing capacity

### Performance Monitoring

Track key metrics:

* **Active Orders**: Monitor current workload and identify peak times
* **Completed Orders**: Measure daily/weekly performance and revenue impact
* **Order Velocity**: Calculate completion rates and processing efficiency

### Staff Management

Use counts to:

* Determine staffing needs during peak hours
* Identify when additional help is needed
* Monitor order processing capacity

### Business Intelligence

Analyze patterns:

* Peak order times for scheduling optimization
* Daily/weekly volume trends
* Capacity planning for busy periods

<Tip>
  Poll this endpoint regularly to create real-time monitoring dashboards that help staff understand current workload and prioritize tasks.
</Tip>

<Note>
  The "active" count includes all orders that require attention or are in progress, while "completed" represents successfully fulfilled orders.
</Note>

<Warning>
  High active order counts may indicate processing bottlenecks or the need for additional staff during peak periods.
</Warning>