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

# GET /coupons/coupon/{couponName}

`GET /coupons/coupon/{couponName}`

## Request

- The document declares no server URL.
- Auth: none required
- TypeScript: <https://skmtc.dev/appcharge/apis/grant-award/docs/coupons/coupon/:couponName/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/appcharge/apis/grant-award.md) - [All operations](https://skmtc.dev/appcharge/apis/grant-award/llms.txt) - [OpenAPI document](https://skmtc.dev/appcharge/apis/grant-award/revisions/b4f6759240d5?raw)