Top Products
GET/api/financials/top-products
Returns the top-performing products ranked by the specified financial metric. Used for dashboard widgets and financial analysis.
Authentication: Requires Bearer token (Power User access required)
Response fields per product:
- product.id, product.name, product.sku, product.image_url
- product.brand: {id, name} (when available)
- quantity_sold: Total units sold
- revenue: Total revenue generated
- costs: Total cost of goods sold
- profit: Total profit (revenue - costs)
- num_orders: Total number of orders
Request
Responses
- 200
Successful response