---
title: "Delete a subscription"
method: DELETE
path: "/subscription/v3/{id}"
tags: ["Subscriptions"]
---

# Delete a subscription

`DELETE /subscription/v3/{id}`

Deletes an existing payment subscription (or pay plan) based on the specified `id`. Deleting a subscription or payment plan cancels it so that the system does not run any more transactions for it. For a payment plan, this may mean that there is still an unpaid balance.

The ID needed for the path parameter is returned in the response for the [Create a subscription](https://docs.nexiopay.com/reference/createsubscription) endpoint. Alternately, you can get the `id` for a subscription if you have a `customerRef` for the [View customer subscriptions](https://docs.nexiopay.com/reference/viewcustomersubscriptions) endpoint.

<!-- theme: warning -->
> ⚠️ Try It
> 
> To use the Try It feature for this endpoint, you can use the credentials for your [Sandbox API user](https://docs.nexiopay.com/docs/sandbox-environments).<br/><br/>You can also use the following test account. Copy the value and paste it into the appropriate space in the Try It section to the right.
> username: `docs@nexiopay.com`
> password: `JZdzoXpdDeH6VA`<br/><br/>Include a subscription ID in the path parameter of the request for a subscription created by the test account.


<div style="display:none;">

## Request parameters
- id

## Response parameters
- message

</div>

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `message` string — Message indicates success or failure for deleting the subscription.

## Other responses

- `401` — Unauthorized. For help with this error and other error codes, see [Common errors](https://docs.nexiopay.com/docs/common-errors) in the Guides area.
- `404` — Not Found.

---

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