---
title: "Get Coupon"
method: GET
path: "/api/v2/coupons/{coupon_id}"
tags: ["Coupons"]
---

# Get Coupon

`GET /api/v2/coupons/{coupon_id}`

Retrieve detailed information about a specific coupon including redemption history.

## Path parameters

- `coupon_id` string, uuid, required — Unique identifier (UUID) of the coupon

## Response `200`

Successful Response

- CouponDetailed
  - `created_at` string, date-time — Creation timestamp of the object.
  - `updated_at` string, date-time, nullable — Last modification timestamp of the object.
  - `id` string, uuid4 — Unique identifier (UUID) of the coupon
  - `name` string — Name of the coupon.
  - `discount_value` string — Discount value of the coupon (either percentage or fixed).
  - `currency` 'SAR' | 'USD' | 'EUR' | 'GBP' | 'AED' | 'BHD' | 'KWD' | 'OMR' | 'QAR' — ISO 4217 currency codes supported by Moyasar. Includes all currencies supported by Moyasar payment gateway.
  - `is_percentage` boolean — True if the discount is a percentage, False if it is a fixed amount.
  - `is_active` boolean — Indicates if the coupon is currently active.
  - `redemptions` integer — Indicates how many times this coupon has been used.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)