---
title: "Remove a discount from a subscription item"
method: DELETE
path: "/billing/subscription_items/{subscription_item_id}/discounts/{discount_id}"
tags: ["Billing"]
---

# Remove a discount from a subscription item

`DELETE /billing/subscription_items/{subscription_item_id}/discounts/{discount_id}`

## Request

- Base URL: `https://api.clerk.com/v1`
- URL: `https://api.clerk.com/v1/billing/subscription_items/{subscription_item_id}/discounts/{discount_id}`
- Auth: HTTP bearer

Removes the active discount from a subscription item.
The discount_id must match the subscription item's currently active discount.

## Path parameters

- `subscription_item_id` string, required
- `discount_id` string, required

## Response `200`

A commerce discount redemption.

- CommerceDiscountRedemptionResponse
  - `object` 'commerce_discount_redemption', required: String representing the object's type. Objects of the same type share the same value.
  - `id` string, required: Unique identifier for the discount redemption.
  - `subscription_item_id` string, required: Unique identifier for the subscription item the discount was applied to.
  - `discount_id` string, required: Unique identifier for the discount that was applied.
  - `name` string: The display name of the discount.
  - `source` 'promotion' | 'manual' | 'promo_code', required: How the discount was applied to the subscription item.
  - `promo_code` string: The promo code used to redeem the discount, when applicable.
  - `effect` 'percentage' | 'fixed_amount': The snapshotted discount effect.
  - `percent_off` number, double, nullable: Percent off when the effect is percentage.
  - `amount_off` CommerceMoneyResponse
    - `amount` integer, required: The amount in cents.
    - `amount_formatted` string, required: The formatted amount as a string (e.g., "$49.99").
    - `currency` string, required: The currency code (e.g., "USD").
    - `currency_symbol` string, required: The currency symbol (e.g., "$").
  - `amount` CommerceMoneyResponse
    - `amount` integer, required: The amount in cents.
    - `amount_formatted` string, required: The formatted amount as a string (e.g., "$49.99").
    - `currency` string, required: The currency code (e.g., "USD").
    - `currency_symbol` string, required: The currency symbol (e.g., "$").
  - `cycles_remaining` integer, nullable, required: Remaining billing cycles the discount applies to. Null means the discount lasts forever.
  - `cycles_applied` integer, required: Number of billing cycles the discount has already been applied to.
  - `status` 'active' | 'exhausted' | 'removed': Current status of the discount redemption.
  - `redeemed_at` integer, required: Unix timestamp (in milliseconds) when the discount was redeemed.
  - `redeemed_by` string, nullable, required: Identifier of the actor that redeemed the discount, when available.

## Other responses

- `400`: Request was not successful
- `401`: Authentication invalid
- `403`: Authorization invalid
- `404`: Resource not found
- `409`: Conflict
- `422`: Invalid request parameters
- `500`: Request was not successful

## Changes

- **2026-08-14** (2025-11-10) `9c094882e00b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/clerk/apis/clerk-backend-api/changes/billing/subscription_items/:subscription_item_id/discounts/:discount_id/delete.md)

---

[API](https://skmtc.dev/clerk/apis/clerk-backend-api.md) - [All operations](https://skmtc.dev/clerk/apis/clerk-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/clerk/apis/clerk-backend-api/revisions/a490313abffa?raw)