---
title: "Revoke Subscription"
method: DELETE
path: "/v1/subscriptions/{id}"
tags: ["subscriptions", "public"]
---

# Revoke Subscription

`DELETE /v1/subscriptions/{id}`

Revoke a subscription, i.e cancel immediately.

**Scopes**: `subscriptions:write`

## Path parameters

- `id` string, uuid4, required — The subscription ID.

## Response `200`

Subscription revoked.

- Subscription — unresolved $ref

## Other responses

- `403` — This subscription is already revoked.
- `404` — Subscription not found.
- `409` — Subscription is pending an update.
- `422` — Validation Error

## Changes

> 11 revisions in range; 5 could not be searched.

- **2026-07-31** `8ae937367e87` — 4 info
  - added the required property `discount/anyOf[subschema #1: SubscriptionDiscount]/oneOf[subschema #1: DiscountFixedOnceForeverDurationBase]/max_redemptions_per_customer` to the response with the `200` status
  - added the required property `discount/anyOf[subschema #1: SubscriptionDiscount]/oneOf[subschema #2: DiscountFixedRepeatDurationBase]/max_redemptions_per_customer` to the response with the `200` status
  - added the required property `discount/anyOf[subschema #1: SubscriptionDiscount]/oneOf[subschema #3: DiscountPercentageOnceForeverDurationBase]/max_redemptions_per_customer` to the response with the `200` status
  - added the required property `discount/anyOf[subschema #1: SubscriptionDiscount]/oneOf[subschema #4: DiscountPercentageRepeatDurationBase]/max_redemptions_per_customer` to the response with the `200` status

[Change history](https://skmtc.dev/polar/apis/polar-api/changes/v1/subscriptions/:id/delete.md)

---

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