---
title: "Top offerings report"
method: GET
path: "/shop/reports/top-offerings"
tags: ["Reports"]
---

# Top offerings report

`GET /shop/reports/top-offerings`

Returns the top-selling offerings (appointments, sessions, products, packages, etc.)
across the filter range, alongside per-offering-type roll-up totals. Useful for
headline "what's our best seller" dashboards.

For background CSV delivery, use
[`/shop/reports/top-offerings/queue`](/endpoints/Reports#queueTopOfferingsExport).

## Query parameters

- `site_id` string, uuid
- `revenue_date_from` string, date
- `revenue_date_to` string, date
- `item_date_from` string, date
- `item_date_to` string, date
- `offering_type` string
- `offering_ids` string[]

## Response `200`

The report was successfully generated.

- TopOfferingsResponse
  - `data` TopOffering[], required — The top offerings by item count and revenue across the filter range.
    - `offering_id` string, object-id, required
    - `offering_type` string, required
    - `offering_name` string, required
    - `num_standalone_items` integer, required — Number of times the offering was sold as a standalone item.
    - `num_package_items` integer, required — Number of times the offering was sold as part of a package.
    - `gross_revenue` integer, required — Combined gross revenue for the standalone sales, in minor units.
    - `net_revenue` integer, required — Combined net revenue for the standalone sales, in minor units.
  - `totals` TopOfferingTotals, required
    - `by_offering_type` array[], required — Each entry rolls up the offerings of a single type — appointment, session, package, etc.
      - TopOfferingTypeTotal[]
        - `offering_type` string, required
        - `num_standalone_items` integer, required
        - `num_package_items` integer, required
        - `gross_revenue` integer, required
        - `net_revenue` integer, required

## Other responses

- `400` — The request failed.

---

[API](https://skmtc.dev/try/apis/trybe-api.md) · [All operations](https://skmtc.dev/try/apis/trybe-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/try/trybe-api/revisions/f37f92702da5/schema)