---
title: "Fetch Discount"
method: GET
path: "/discounts/{id}"
tags: ["Discount"]
---

# Fetch Discount

`GET /discounts/{id}`

## Request

- Base URL: `https://myworkspace.myclickfunnels.com/api/v2`
- URL: `https://myworkspace.myclickfunnels.com/api/v2/discounts/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://accounts.myclickfunnels.com/oauth/authorize`
    - Token URL: `https://accounts.myclickfunnels.com/oauth/token`
- TypeScript: <https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/docs/discounts/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a single discount.

## Path parameters

- `id` string, required

## Response `200`

OK

- DiscountAttributes: A reusable, workspace-scoped discount applied on top of a price.
  - `id` integer: Discount ID
  - `public_id` string, nullable: Discount public ID
  - `workspace_id` integer: Workspace ID
  - `name` string: Internal name for the discount.
  - `code` string: The code a buyer redeems at checkout. Uppercased on save; unique within the workspace (cannot collide with a coupon code).
  - `discount_type` 'code' | 'automatic' | 'sale': `code` (the default) is a redeemable coupon code. `automatic` and `sale` are deprecated.
  - `discount_method` 'percentage' | 'fixed' | 'shipping' | 'bogo': How the discount is calculated. `percentage` uses `percent`; `fixed` uses `amount`. `shipping` and `bogo` exist but are outside the simple flow.
  - `amount` string, nullable: Fixed amount off, as a decimal string (e.g. "10.00"). `null` for a percentage discount.
  - `percent` string, nullable: Percentage off between 0.01 and 100 (e.g. "20.0"). `null` for a fixed discount.
  - `currency` string: ISO currency code, lowercased. Defaults to the workspace currency.
  - `applies_to` 'all_products' | 'specific_products' | 'specific_variants' | 'specific_collections': Scope of the discount. `all_products` (the default) applies workspace-wide; the `specific_*` values restrict it to the ids passed in `product_ids` / `variant_ids` / `products_collection_ids`.
  - `apply_from` string, date-time: When the discount becomes active. Defaults to the creation time.
  - `apply_until` string, date-time, nullable: When the discount expires. `null` means it never expires.
  - `limit_1_per_customer` boolean: When true, each contact can redeem the discount only once.
  - `require_minimum_spend` boolean: When true, the order must meet `require_minimum_spend_amount` for the discount to apply.
  - `require_minimum_spend_amount` integer, nullable: Minimum order subtotal required, when `require_minimum_spend` is true. In whole currency units, not cents - `50` on a `usd` discount means $50.
  - `discounts_per_redemption` integer, nullable: Optional cap on how many line items a single redemption discounts.
  - `redemptions_count` integer: How many times the discount has been redeemed on an invoice. On Stripe every invoice counts, renewals included; on Payments AI each customer redemption counts once, however many renewal invoices it covers. This is not a deletability signal - a discount can report zero redemptions and still return 422 on DELETE because it is applied to an order that has no invoice yet.
  - `product_ids` integer[]: The products the discount is scoped to (empty unless `applies_to` is `specific_products`).
  - `variant_ids` integer[]: The variants the discount is scoped to (empty unless `applies_to` is `specific_variants`).
  - `products_collection_ids` integer[]: The collections the discount is scoped to (empty unless `applies_to` is `specific_collections`).
  - `active` boolean: Derived - true when the discount is neither scheduled for the future nor expired.
  - `expired` boolean: Derived - true when `apply_until` is in the past. An expired discount is frozen - every further update returns 422, so rename before you expire.
  - `scheduled` boolean: Derived - true when `apply_from` is in the future.
  - `created_at` string, date-time, nullable: Added
  - `updated_at` string, date-time, nullable: Updated

## Other responses

- `401`: Unauthorized
- `403`: Forbidden - the access token's scopes do not cover this request
- `404`: Not Found

## Changes

- **2026-11-03** `511d88b30aea`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/changes/discounts/:id/get.md)

---

[API](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api.md) - [All operations](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/llms.txt) - [OpenAPI document](https://skmtc.dev/myclickfunnels/apis/clickfunnels-api/revisions/511d88b30aea?raw)