Skip to content

Reporting — Overview (GraphQL)

Query: statsAdminReportingOverview.

The Overview query returns a single headline figure across the whole store for the chosen type. It is an API convenience aggregation — there is no matching "Overview" screen in the admin panel (the admin Reporting menu goes straight to Sales / Customers / Products). Use it to fetch one top-line number without having to call the per-section queries.

The type argument picks which headline you get back:

  • total-sales (default) — total revenue for the period.
  • total-orders — number of orders placed.
  • total-customers — number of new customers.
  • top-selling-products-by-revenue — the best-selling product by revenue.

The statistics object carries a previous-vs-current comparison plus a progress percentage (how the current window compares to the previous one), and for time-based types an over_time series of per-day data points for charting. dateRange reports the two comparison windows — current is the window you asked for, previous is the equal-length window immediately before it.

Arguments

ArgTypeNotes
typeStringtotal-sales (default), total-orders, total-customers, top-selling-products-by-revenue.
startStringStart of the reporting window (YYYY-MM-DD).
endStringEnd of the reporting window (YYYY-MM-DD).
channelStringChannel code (e.g. default) — scopes the figures to one storefront channel.

Unlike the Sales / Customers / Products queries, the Overview query has no View Details and no Export — it is a top-line summary only. Reporting requires only authentication; there is no permission gate.

Released under the MIT License.