---
title: "Cancel a subscription"
method: POST
path: "/v1/subscriptions/{id}/cancel"
tags: ["Subscriptions"]
---

# Cancel a subscription

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

Cancel a subscription. By default, cancels at the end of the current billing period.

## Path parameters

- `id` string, required

## Request body

- object
  - `immediate` boolean — Cancel immediately instead of at period end

## Response `200`

Subscription cancelled

- object — Subscription cancelled

## Other responses

- `400` — Invalid state
- `401` — Unauthorized
- `404` — Subscription not found

---

[API](https://skmtc.net/usedrip/apis/drip-api.md) · [All operations](https://skmtc.net/usedrip/apis/drip-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usedrip/drip-api/versions/2cb1567969ca/schema)