Billing

Remove a discount from a subscription item

Changed on

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

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

Path parameters

subscription_item_idstring required

The ID of the subscription item to remove the discount from

discount_idstring required

The ID of the discount to remove

Response

A commerce discount redemption.

object'commerce_discount_redemption' required

String representing the object's type. Objects of the same type share the same value.

idstring required

Unique identifier for the discount redemption.

subscription_item_idstring required

Unique identifier for the subscription item the discount was applied to.

discount_idstring required

Unique identifier for the discount that was applied.

namestring

The display name of the discount.

source'promotion' | 'manual' | 'promo_code' required

How the discount was applied to the subscription item.

promo_codestring

The promo code used to redeem the discount, when applicable.

effect'percentage' | 'fixed_amount'

The snapshotted discount effect.

percent_offnumber double nullable

Percent off when the effect is percentage.

cycles_remaininginteger nullable required

Remaining billing cycles the discount applies to. Null means the discount lasts forever.

cycles_appliedinteger required

Number of billing cycles the discount has already been applied to.

status'active' | 'exhausted' | 'removed'

Current status of the discount redemption.

redeemed_atinteger required

Unix timestamp (in milliseconds) when the discount was redeemed.

redeemed_bystring nullable required

Identifier of the actor that redeemed the discount, when available.

Changes