---
title: "Delete a subscription by number"
method: PUT
path: "/v1/subscriptions/{subscription-key}/delete"
tags: ["Subscriptions"]
---

# Delete a subscription by number

`PUT /v1/subscriptions/{subscription-key}/delete`

This REST API reference describes how to delete a subscription of the specified subscription number.

## Path parameters

- `subscription-key` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- PUTDeleteSubscriptionResponseType
  - `success` boolean — Returns `true` if the request is processed successfully.

## Other responses

- `500` — Internal Server Error
- `4XX` — Request Errors

---

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