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

# Cancel Subscription

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

Cancel a subscription. This cancels any of the subscription's orders that are currently `scheduled`, `paused`, or `payment_failed`; no further orders will be placed.

## Path parameters

- `subscription_id` string, required — The unique ID for a Bolt subscription.

## Headers

- `X-Publishable-Key` string, required

## Response `200`

Success

- SubscriptionV2Success — A generic confirmation response.
  - `success` boolean, required

## Other responses

- `400` — BAD REQUEST. Request is malformed, or the subscription is not in a cancellable state.
- `401` — UNAUTHORIZED. Missing or invalid X-API-Key or X-Publishable-Key.
- `404` — NOT FOUND. Unable to find a subscription with this ID for this merchant division.

## Changes

- **2026-07-31** `1f62c40558c6` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bolt/apis/bolt-api-reference/changes/v1/subscriptions/:subscription_id/cancel/post.md)

---

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