---
title: "Discount usage report (v2)"
method: GET
path: "/shop/reports/discount-usage-v2"
tags: ["DiscountUsage"]
---

# Discount usage report (v2)

`GET /shop/reports/discount-usage-v2`

Returns discount usage as a JSON-native list: one row per discount type, with counts
and total amounts (in minor units) for baskets, items, and the combined total.

Prefer this endpoint over [`/shop/reports/discount-usage`](/endpoints/DiscountUsage#listDiscountUsage)
when integrating with another system.

## Query parameters

- `site_id` string, uuid
- `revenue_date_from` string, date
- `revenue_date_to` string, date
- `submitted_at_from` string, date
- `submitted_at_to` string, date

## Response `200`

The report was successfully generated.

- DiscountUsageV2Response
  - `data` DiscountUsageRow[], required — One entry per discount type that was offered or applied in the filter range.
    - `discount_type_id` string, object-id, required
    - `is_deleted` boolean — Whether the discount type has been soft-deleted.
    - `site_id` string, uuid, nullable
    - `discount_type_name` string, required
    - `discount_type_code` string, nullable
    - `num_baskets` integer, required — Number of baskets the discount was applied to.
    - `num_items` integer, required — Number of basket items the discount was applied to.
    - `basket_discount_total` integer, required — The total amount discounted at the basket level, in minor units.
    - `item_discount_total` integer, required — The total amount discounted at the item level, in minor units.
    - `discount_total` integer, required — The combined total of basket-level and item-level discount amounts, in minor units.

## Other responses

- `400` — The request failed.
- `401` — The user is unauthenticated

---

[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)