---
title: "GET /coupons/coupon/{couponName}/promo-code/{promoCodeName}"
method: GET
path: "/coupons/coupon/{couponName}/promo-code/{promoCodeName}"
tags: ["Promo Codes"]
---

# GET /coupons/coupon/{couponName}/promo-code/{promoCodeName}

`GET /coupons/coupon/{couponName}/promo-code/{promoCodeName}`

Retrieves a specific promo code.

## Response `200`

Promo code retrieved successfully.

- PromoCodeResponse
  - `name` string — Promo code name.
  - `active` boolean — Whether the promo code is active.
  - `maxRedemptions` integer — Maximum number of times this promo code can be redeemed.
  - `createdAt` string, date-time — Timestamp when the promo code was created.
  - `updatedAt` string, date-time — Timestamp when the promo code was last updated.
  - `redemptions` integer — Number of times this promo code has been redeemed.

## Other responses

- `400` — Bad request. Invalid input or validation failure.
- `404` — Promo code or 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/revisions/b4f6759240d5/schema)