---
title: "Cancel Subscription"
method: POST
path: "/v1/subscriptions/{subId}/cancel"
tags: ["Manage Subscription"]
---

# Cancel Subscription

`POST /v1/subscriptions/{subId}/cancel`

This will cancel the subscription by subscription Id and Subscription state changes to Cancelled

## Path parameters

- `subId` string, required

## Headers

- `token` string, required

## Request body

- CancelSubscriptionRequest
  - `suppressCancelNotification` boolean — The clients can use this element to suppress cancel notification email.By default this is false.
  - `cancelReasonCode` string — Optional, you can specify the codes used to categorize the reason for the subscription cancellation. This field can contain up to 64 characters.
  - `cancelComment` string — An optional comment provided by the shopper detailing additional information or context regarding the subscription cancellation. This field can contain up to 255 characters.

## Response `202`

Accepted

## Other responses

- `400` — * Bad request
- `401` — Please verify your API key and secret (if applicable) is correct.
- `403` — * Access Denied
- `404` — * Not found
- `409` — * Conflict

---

[API](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis.md) · [All operations](https://skmtc.net/digitalriver/apis/commerce-api-suite-admin-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/digitalriver/commerce-api-suite-admin-apis/revisions/a6efafc1669c/schema)