---
title: "Get Top Selling Items"
method: GET
path: "/dashboard/top-selling-items"
tags: ["provider", "dashboard"]
---

# Get Top Selling Items

`GET /dashboard/top-selling-items`

## Request

- Base URL: `https://docs.decodahealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.decodahealth.com/dashboard/top-selling-items`
- Auth: none declared. Required headers: `TENANT`, `API-KEY`
- TypeScript: <https://skmtc.dev/decodahealth/apis/decoda-api/docs/dashboard/top-selling-items/get.ts> (a function with typed inputs; its response is checked against the schema)

Get top selling items based on the number of times they were purchased.
Returns the top items sorted by purchase count.

## Query parameters

- `page` integer, nullable
- `per_page` integer, nullable
- `sort_by` string, nullable
- `sort_direction` 'asc' | 'desc', nullable
- `location_id` string, nullable
- `start_date` string, required
- `end_date` string, required
- `location_ids` string[], nullable
- `payment_mediums` string[], nullable
- `tz` string, required
- `limit` integer, nullable

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Response `200`

Successful Response

- TopSellingItem[]
  - `id` string, required
  - `name` string, required
  - `description` string, nullable
  - `price` number, required
  - `totalQuantity` integer, required
  - `numberOfPurchases` integer, required
  - `totalRevenue` number, required
  - `averageQuantityPerPurchase` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) - [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) - [OpenAPI document](https://skmtc.dev/decodahealth/apis/decoda-api/revisions/4ab18c80f9e9?raw)