Overview

Analytics use Order for completed-order counts and InvoiceV2 for revenue and product-level reporting. The legacy invoice table is not part of this contract.

The endpoint defaults to the summary section. Add only the sections needed by the caller to keep responses small.

Endpoint

• Retrieve store analytics

Authorization

The API token needs the invoice ability, and the authenticated user must have invoice dashboard permission for the store selected by the X-STORE header.

Money and dates

• Revenue totals are integer minor units unless a field explicitly says it is formatted.
• Fields ending in _cents, including average_revenue_usd_cents, are integer minor units.
• Date filters are interpreted in the store timezone and are inclusive.
• A single request is limited to 366 calendar days.