Get sales metrics
Retrieves aggregated sales metrics for a specified date range. Returns hourly or daily granularity with order counts and sales totals grouped by currency.
GET
/api/v1/{team_slug}/{app_slug}/orders/metricsAuthorization
AuthorizationBearer token · headerrequiredManagement API token, sent as Authorization: Bearer <token>.
Path parameters
app_slugstringrequiredApp slug
team_slugstringrequiredTeam slug
Query parameters
start_datestringrequiredStart date (YYYY-MM-DD)
end_datestringrequiredEnd date (YYYY-MM-DD)
granularitystringGranularity of the metrics (hour, day)
Responses
200
Sales metrics with order counts retrieved successfully
datainternal_pkg_webserver_v1.SalesMetricsDataResponserequiredShow propertiesHide properties
daily_metricsinternal_pkg_webserver_v1.DailySalesMetricResponse[]Show propertiesHide properties
Array of
internal_pkg_webserver_v1.DailySalesMetricResponsedaystringorder_countintegersales_by_currencyinternal_pkg_webserver_v1.SalesByCurrency[] | nullhourly_metricsinternal_pkg_webserver_v1.HourlySalesMetricResponse[]Show propertiesHide properties
Array of
internal_pkg_webserver_v1.HourlySalesMetricResponsehourstringorder_countintegersales_by_currencyinternal_pkg_webserver_v1.SalesByCurrency[] | nulltotal_order_countintegertotal_sales_by_currencyinternal_pkg_webserver_v1.SalesByCurrency[] | nullShow propertiesHide properties
Array of
internal_pkg_webserver_v1.SalesByCurrencycurrency_codestringtotal_compensated_salesnumbertotal_sales_amountnumberdetailsstring[]Additional contextual information about the response. Used to provide supplementary details beyond the main data payload, such as validation warnings or processing notes
successbooleanrequired400
Invalid date format or missing parameters
detailsstring[]messagestringsuccessbooleanrequired401
Unauthorized access
detailsstring[]messagestringsuccessbooleanrequired500
Internal server error
detailsstring[]messagestringsuccessbooleanrequired