Statistics
The Statistics API exposes detailed store metrics — revenue, sales, transactions, conversion, average order value, and more — as JSON.
Overview
The Statistics API provides a single endpoint:
Each call returns one statistic as a time-bucketed series for the
selected period, the matching previous-period series for comparison, and a
server-computed change block summarising the delta. To pull several
statistics at once, call the endpoint in parallel with different type
values.
Stat types
| Type | Domain | Notes |
|---|---|---|
revenue | money | Gross order revenue |
sales | count | Completed orders |
transactions | count | Captured payment transactions |
checkout_sessions | count | Initiated checkouts |
customers | count | New paying customers |
conversion | rate | Checkouts that converted to a sale (%) |
recovered_revenue | money | Revenue rescued via abandoned-checkout follow-ups |
partners_revenue | money | Revenue attributed to your affiliate partners. Sale amount, not commission — per-partner totals are on Partners and the rows are on Partner Transactions. |
automation_runs | count | Automation triggers fired |
free_products | count | Free-product redemptions |
average_order_value | money | Average order value across completed orders |
average_customer_lifetime_value | money | Average lifetime spend per customer |
Money values are returned as integers in minor units (e.g. 12500 =
125.00 USD). Count stats are plain counts. conversion is a whole-number
percentage recomputed over the whole period (orders vs. checkout sessions); it
can exceed 100 when orders outnumber sessions, and is not the sum of the daily
rates.
Currency
Every call requires a currency query parameter — figures are scoped to a
single currency, and there is no store-level default. See
GET /store for the currencies your store transacts in.
Zero-activity responses
A date range with no activity returns a clean zero-shaped response
(data: [], totals at 0, change at 0) with a date_range
echoing the requested period — not an error.