---
title: "Cancel a subscription"
method: DELETE
path: "/v3/subscriptions/{subscription_id}"
tags: ["Subscriptions"]
---

# Cancel a subscription

`DELETE /v3/subscriptions/{subscription_id}`

This endpoint allows cancellation of an existing subscription by ID.

## Path parameters

- `subscription_id` integer, required

## Headers

- `Content-Type` string, required
- `X-Date` string, date-time, required
- `X-Login` string, required
- `Authorization` string, required
- `X-Idempotency-Key` string

## Request body

- object

## Response `200`

Subscription successfully cancelled

- object

## Other responses

- `420` — Subscription does not exist
- `421` — Subscription was already cancelled
- `426` — Subscription is terminated and cannot be cancelled
- `501` — Generic Error

---

[API](https://skmtc.net/d24/apis/docs-d24-com.md) · [All operations](https://skmtc.net/d24/apis/docs-d24-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d24/docs-d24-com/versions/fb0e2ddec198/schema)