Skip to main content

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

Successful response