---
title: "Get coupon code usage statistics"
method: GET
path: "/shop/coupon-codes/{code}/usage-stats"
tags: ["CouponCodes"]
---

# Get coupon code usage statistics

`GET /shop/coupon-codes/{code}/usage-stats`

Gets the usage statistics for a coupon code at a specific booking date. Returns null data if the coupon has no usage limits configured.

## Query parameters

- `booking_date` string, required
- `site_id` string, required
- `offering_id` string

## Response `200`

Usage statistics retrieved successfully

- object
  - `data` CouponCodeUsageStats, required
    - `max_uses` integer, required — The maximum number of times this coupon can be used within the period
    - `current_uses` integer, required — The number of times this coupon has been used in the current period
    - `remaining_uses` integer, required — The number of remaining uses available in the current period
    - `period` 'P1D' | 'P1W' | 'P1M' | 'P1Y', required — The time period for usage limits as an ISO8601 duration string
    - `period_label` 'daily' | 'weekly' | 'monthly' | 'yearly', required — Human-readable label for the period
    - `period_start` string, date, required — The start date of the current usage period
    - `period_end` string, date, required — The end date of the current usage period
    - `would_exceed_limit` boolean, required — Whether adding another usage would exceed the limit

## Other responses

- `401` — The user is unauthenticated
- `404` — The resource couldn't be found
- `422` — The request didn't pass validation

---

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