---
title: "Delete a discount"
method: DELETE
path: "/discounts/{id}"
tags: ["Discounts"]
---

# Delete a discount

`DELETE /discounts/{id}`

Delete a discount

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required
- `sequence-version` '2024-07-30'

## Response `200`

OK

- DiscountResponse
  - `id` string, required — Discount ID
  - `sequenceAccountId` string, required — The Sequence Account to which this Discount belongs
  - `billingScheduleId` string, required — Billing Schedule ID
  - `phaseId` string — Phase ID
  - `priceIds` string[], required — Price IDs this discount applies to. If not populated, the discount applies to all prices on the billing schedule
  - `separateLineItem` boolean, required — Indicates whether the discount should appear as a separate line item in the invoice
  - `amount` number, required — Amount to be reduced
  - `discountCalculationType` 'PERCENTAGE' | 'NOMINAL', required
  - `message` string, required — Message to appear on the Invoice
  - `validFrom` string — First Day Discount is Valid
  - `validTo` string — Last Day Discount is Valid
  - `createdAt` string, required — Created at
  - `updatedAt` string, required — Updated At
  - `seatDiscountType` 'INCLUDED_SEATS_ONLY' | 'OVERAGE_SEATS_ONLY' | 'ALL_SEATS', required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

## Changes

> 714 revisions in range; 511 could not be searched.

- **2026-06-13** `02acff42af53` — 2 breaking, 1 warning, 1 info
  - the `validFrom` response's property type/format changed from `string`/`date` to `string`/`` for status `200`
  - the `validTo` response's property type/format changed from `string`/`date` to `string`/`` for status `200`
  - deleted the `header` request parameter `Sequence-Version`
  - added the new optional `header` request parameter `sequence-version`

[Change history](https://skmtc.dev/sequencehq/apis/sequence/changes/discounts/:id/delete.md)

---

[API](https://skmtc.dev/sequencehq/apis/sequence.md) · [All operations](https://skmtc.dev/sequencehq/apis/sequence/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequencehq/sequence/revisions/e520d2f95b7b/schema)