---
title: "Get store metrics summary"
method: GET
path: "/v1/stats/summary"
tags: ["Stats"]
---

# Get store metrics summary

`GET /v1/stats/summary`

Retrieve aggregated store metrics including counts, revenue, and MRR. When startDate and endDate are provided, totals are filtered to that date range. When interval is also provided, the response includes a periods array with time-series data points grouped by that interval. The periods array starts from the store's first transaction or startDate, whichever is later, to avoid empty leading buckets. All monetary amounts are in cents (integer, no decimals).

## Query parameters

- `startDate` number
- `endDate` number
- `interval` 'day' | 'week' | 'month'
- `currency` 'EUR' | 'USD', required

## Response `200`

Successfully retrieved store metrics summary

- StatsSummaryEntity
  - `totals` StatsMetricTotalsEntity, required
    - `totalProducts` number, required — Total number of products in the store
    - `totalSubscriptions` number, required — Total number of subscriptions within the queried date range
    - `totalCustomers` number, required — Total number of customers within the queried date range
    - `totalPayments` number, required — Total number of payments within the queried date range
    - `activeSubscriptions` number, required — Number of currently active subscriptions
    - `totalRevenue` number, required — Total gross revenue in cents within the queried date range
    - `totalNetRevenue` number, required — Total net revenue in cents within the queried date range (after fees and taxes)
    - `netMonthlyRecurringRevenue` number, required — Net monthly recurring revenue in cents (after estimated fees)
    - `monthlyRecurringRevenue` number, required — Gross monthly recurring revenue in cents
  - `periods` StatsMetricPeriodEntity[] — Time-series data points grouped by the requested interval. Only present when interval, startDate, and endDate are provided.
    - `timestamp` number, required — Start of the period as a Unix timestamp in milliseconds (e.g. Monday of that week for weekly intervals)
    - `grossRevenue` number, required — Gross revenue in cents for this period
    - `netRevenue` number, required — Net revenue in cents for this period (after fees and taxes)

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.net/creem/apis/creem-api.md) · [All operations](https://skmtc.net/creem/apis/creem-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/creem/creem-api/revisions/aa593160d96c/schema)