---
title: "GET /coupons/coupon/{couponName}"
method: GET
path: "/coupons/coupon/{couponName}"
tags: ["Coupons"]
---

# GET /coupons/coupon/{couponName}

`GET /coupons/coupon/{couponName}`

Retrieves a specific coupon by name.

## Response `200`

Coupon retrieved successfully.

- CouponResponse
  - `name` string — Coupon name.
  - `active` boolean — Whether the coupon is active.
  - `discountPercentage` number — Discount percentage applied by the coupon.
  - `maxRedemptionsPerCustomer` integer — Maximum number of times a customer can redeem this coupon.
  - `expiredBy` string, date-time — Expiration date of the coupon.
  - `startsAt` string, date-time — Start date of the coupon validity.
  - `supportedOfferExternalIds` string[] — List of offer external IDs that support this coupon. Empty array means all offers are supported.
  - `firstTimePurchase` boolean — Whether the coupon is only valid for first-time purchases.
  - `allowedPlayers` string[] — List of player IDs allowed to use this coupon. Empty array means all players are allowed.

## Other responses

- `400` — Invalid coupon name.
- `404` — Coupon not found.
- `500` — Unexpected error.

---

[API](https://skmtc.net/appcharge/apis/grant-award.md) · [All operations](https://skmtc.net/appcharge/apis/grant-award/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/appcharge/grant-award/versions/b4f6759240d5/schema)