---
title: "Cancel subscription"
method: POST
path: "/2023-10/subscription/{subscriptionId}/cancel"
---

# Cancel subscription

`POST /2023-10/subscription/{subscriptionId}/cancel`

## Request

- Base URL: `https://api.loopsubscriptions.com/admin`
- URL: `https://api.loopsubscriptions.com/admin/2023-10/subscription/{subscriptionId}/cancel`
- Auth: API key in header `X-Loop-Token`

This endpoint allows you to cancel an active or paused subscription, stopping all future billing and deliveries permanently or until reactivated by the customer or merchant.

## Path parameters

- `subscriptionId` integer, required

## Request body

- object
  - `cancellationFlowId` integer: Identifier for the cancellation flow selected by the customer or merchant. This is used to track the cancellation analytics.
  - `comment` string: Optional text field used to capture additional notes or remarks provided by the customer during the cancellation of the subscription.
  - `notifyCustomer` boolean: Optional parameter that determines whether a cancellation email should be sent to the customer. Defaults to true if not specified.
  - `markForCancellation` boolean: Applicable only for prepaid subscriptions. If set to `true`, the subscription will be marked for cancellation and will cancel after all orders in the current prepaid cycle are fulfilled. If set to `false`, the subscription will be cancelled immediately.

## Response `200`

200

- object
  - `success` boolean
  - `message` string
  - `data` unknown
  - `code` string

---

[API](https://skmtc.dev/loopwork/apis/loop-admin.md) - [All operations](https://skmtc.dev/loopwork/apis/loop-admin/llms.txt) - [OpenAPI document](https://skmtc.dev/loopwork/apis/loop-admin/revisions/1eaf81bcb1ea?raw)
