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

# Sales Analytics

> Sales totals, conversion rate, AOV, and breakdowns for the range.

Sales-focused breakdown of the requested range — gross sale, AOV, returning
customer rate, tax collected, and per-region totals.

**Required scope:** `read_analytics`

## Query Parameters

<ParamField query="range" type="string" default="last_7_days">
  Predefined range (same options as `/summary`).
</ParamField>

<ParamField query="start" type="string">Custom range start (ISO 8601).</ParamField>
<ParamField query="end" type="string">Custom range end (ISO 8601).</ParamField>

## Response

<ResponseField name="data" type="object">
  <Expandable title="sales">
    <ResponseField name="grossSale" type="number">Total sales in range.</ResponseField>
    <ResponseField name="averageOrderValue" type="number">Average order value.</ResponseField>
    <ResponseField name="avgSalePerDay" type="number">Average daily sales.</ResponseField>
    <ResponseField name="avgOrders" type="number">Average daily orders.</ResponseField>
    <ResponseField name="conversionRate" type="number">Sessions → orders (%).</ResponseField>
    <ResponseField name="cancelOrdersCount" type="number">Cancelled order count.</ResponseField>
    <ResponseField name="canceledOrdersAmount" type="number">Cancelled order value.</ResponseField>
    <ResponseField name="totalCustomers" type="number">Distinct customers.</ResponseField>
    <ResponseField name="returningCustomers" type="number">Returning customers.</ResponseField>
    <ResponseField name="returningCustomerRate" type="number">Returning-customer rate (%).</ResponseField>
    <ResponseField name="taxCollected" type="number">Tax collected on orders.</ResponseField>
    <ResponseField name="ordersData" type="object">`{ totalOrders, ordersByDay }`.</ResponseField>
    <ResponseField name="saleByTopRegion" type="object">Map of region → sales total.</ResponseField>
    <ResponseField name="viewDataByDays" type="number">Sessions in range.</ResponseField>
    <ResponseField name="viewsByDate" type="object">Map of date → views.</ResponseField>
    <ResponseField name="sourceCount" type="object">Map of traffic source → views.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": null,
    "data": {
      "grossSale": 0,
      "averageOrderValue": 0,
      "avgSalePerDay": 0,
      "avgOrders": 0,
      "conversionRate": 0,
      "cancelOrdersCount": 0,
      "canceledOrdersAmount": 0,
      "totalCustomers": 0,
      "returningCustomers": 0,
      "returningCustomerRate": 0,
      "taxCollected": 0,
      "ordersData": { "totalOrders": 0, "ordersByDay": {} },
      "saleByTopRegion": {},
      "viewDataByDays": 0,
      "viewsByDate": {},
      "sourceCount": {}
    },
    "pagination": null
  }
  ```
</ResponseExample>