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

# Retrieve a coupon

`GET /coupons/{coupon_id}`

Returns full details for a specific coupon by its path identifier.

## Path parameters

- `coupon_id` string, required

## Query parameters

- `expand` boolean

## Response `200`

Successful response.

- CouponResponse — Full coupon details.
  - `coupon` string — Unique coupon path identifier.
  - `discount` DiscountResponseConfig — Discount type and amount configuration.
    - `type` 'percent' | 'flat' — Discount type. **(Beta)** Must be `flat` when `orderLevelDiscount` is `true`.
    - `percent` number — Percentage amount to discount. Required when `type` is `percent`. Decimal values are accepted.
    - `amount` object — Per-currency flat discount amounts. Required when `type` is `flat`. All values must be greater than `0`.
      - `USD` number, float — US Dollar amount.
      - `EUR` number, float — Euro amount.
      - `GBP` number, float — British Pound amount.
    - `hasMultipleDiscounts` boolean — Indicates whether this coupon uses a multi-tier discount configuration.
    - `discounts` MultiDiscountTier[] — Array of multi-tier discount configurations. Populated only when `hasMultipleDiscounts` is `true`.
      - `type` 'percent' | 'flat' — Discount type for this tier.
      - `percent` number — Percentage amount for this tier. Required when `type` is `percent`. Decimal values are accepted.
      - `amount` object — Per-currency flat discount amounts for this tier. Required when `type` is `flat`.
        - `USD` number, float
        - `EUR` number, float
        - `GBP` number, float
      - `products` string[] — Product path identifiers this tier applies to. Omit to apply this tier to all products. At most one tier per coupon may omit this field.
      - `discountPeriodCount` integer — Number of billing periods this tier's discount applies to.
      - `applyDiscountImmediately` boolean — Applies this tier's discount starting in the first billing period rather than the next renewal period.
  - `discountPeriodCount` integer, nullable — Number of billing periods the discount applies to. `null` means unlimited.
  - `applyDiscountImmediately` boolean — Indicates the discount applies starting in the first billing period. **Note:** Only present in the response when `true`. Absence of this field indicates `false`.
  - `combine` boolean — Indicates whether this discount stacks with other active discounts.
  - `orderLevelDiscount` boolean — **(Beta)** Indicates the discount applies to the entire order subtotal. Only returned for coupons created by accounts enrolled in the closed Order-Level Coupons beta. **Note:** Only present in the response when `true`. Absence of this field indicates `false`.
  - `reason` object — Localized discount description. Returns `{}` when no reason is configured.
  - `limit` string — Maximum number of times this discount can be applied. Returns as a string. `""` means unlimited. **Note:** Sending `limit: 0` on create or update is stored and returned as `""`.
  - `available` object — Active date range for the coupon. Returns `{}` when no date restrictions are configured.
    - `start` string
    - `end` string
  - `codes` string[] — Coupon codes associated with this coupon. **Code handling** - **Case:** Codes are normalized to uppercase on storage. A code submitted as `summer10` is stored and returned as `SUMMER10`. Case is not preserved — treat the uppercased form as canonical. - **Pagination:** Limited to 1,000 items on this endpoint. Use `GET /coupons/{coupon_id}/codes` to retrieve the full list for coupons with more than 1,000 codes.
  - `products` unknown[] — Product path identifiers this discount applies to. Returns an empty array if the discount applies to all products. Returns full product objects when the `expand` query parameter is `true`.
    - unknown

## Other responses

- `400` — Validation or request error. Returns `200 OK` — always check the `result` field rather than relying on the HTTP status code alone.

---

[API](https://skmtc.dev/fastspring/apis/fastspring-api-accounts.md) · [All operations](https://skmtc.dev/fastspring/apis/fastspring-api-accounts/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fastspring/fastspring-api-accounts/revisions/ae2f0b97db3e/schema)