---
title: "Per-product sample usage this month"
method: GET
path: "/samples/product-usage"
tags: ["Samples"]
---

# Per-product sample usage this month

`GET /samples/product-usage`

How many samples each product has consumed in the current calendar month (``productId`` → ``usedThisMonth``). This is the counter the portal checks per-product sample limits against, so it answers 'which product is about to run out of its monthly allowance'.

Products with no usage this month are omitted. Single-shop only.

## Response `200`

Successful Response

- ProductUsageResponse
  - `data` ProductUsageItem[], required
    - `productId` string, required
    - `usedThisMonth` integer, required

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)