---
title: "Get KPI stats report"
method: GET
path: "/shop/reports/kpi-stats"
tags: ["Reports"]
---

# Get KPI stats report

`GET /shop/reports/kpi-stats`

Returns per-day basket statistics and range totals over a configurable date range (defaulting to the last 30 days). Shows total basket counts and average values, with website baskets (source=shop_v2) broken out separately. Per-day data includes an entry for every date in the requested range, even when no baskets exist for that day (zero-count entries are included). The summary provides aggregated totals across the entire date range. Requires the `DASHBOARDS_VIEW` permission.

## Query parameters

- `site_id` string, required
- `date_from` string, date
- `date_to` string, date

## Response `200`

KPI stats report data.

- KpiStatsReport
  - `data` object, required
    - `by_date` KpiStatsItem[], required — Per-day basket statistics. Includes an entry for every date in the requested range.
      - `date` string, date, required — The date for this bucket in `yyyy-MM-dd` format.
      - `all_baskets_count` integer, required — Total number of submitted baskets on this date (all sources).
      - `all_baskets_average_value` integer, required — Average `total_cost` in minor currency units across all baskets on this date.
      - `website_baskets_count` integer, required — Number of submitted baskets with `source=shop_v2` on this date.
      - `website_baskets_average_value` integer, required — Average `total_cost` in minor currency units for website baskets on this date.
    - `summary` KpiStatsSummary, required — Aggregated totals across the entire date range.
      - `all_baskets_count` integer, required — Total number of submitted baskets across the entire date range (all sources).
      - `all_baskets_average_value` integer, required — Average `total_cost` in minor currency units across all baskets in the range.
      - `website_baskets_count` integer, required — Total number of submitted baskets with `source=shop_v2` across the entire date range.
      - `website_baskets_average_value` integer, required — Average `total_cost` in minor currency units for website baskets in the range.
  - `meta` KpiStatsMeta, required
    - `currency` string, required — ISO 4217 currency code for the site.

## Other responses

- `400` — The request failed.
- `403` — The authenticated user does not have permission.

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)