---
title: "Cancel subscription"
method: DELETE
path: "/v2/customers/{customerId}/subscriptions/{subscriptionId}"
tags: ["Subscriptions API"]
---

# Cancel subscription

`DELETE /v2/customers/{customerId}/subscriptions/{subscriptionId}`

Cancel an existing subscription. Canceling a subscription has no effect on the mandates of the customer.

## Headers

- `idempotency-key` string

## Request body

- object
  - `testmode` boolean, nullable — Most API credentials are specifically created for either live mode or test mode, in which case this parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting `testmode` to `true`. Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

## Response `200`

The updated subscription object with status `canceled`. For a complete reference of the subscription object,
refer to the [Get subscription endpoint](get-subscription) documentation.

## Other responses

- `404` — No entity with this ID exists.
- `429` — Rate Limit has been reached.

## Changes

> 79 revisions in range; 9 not diffed.

- **2026-06-15** `00fb770ca934` — 10 info
  - the response property `allOf[#/components/schemas/entity-subscription]/_links` became required for the status `200`
  - the response property `allOf[#/components/schemas/entity-subscription]/amount` became required for the status `200`
  - the response property `allOf[#/components/schemas/entity-subscription]/createdAt` became required for the status `200`
  - the response property `allOf[#/components/schemas/entity-subscription]/customerId` became required for the status `200`
  - …6 more
- **2026-06-09** `327472893a89` — 4 info
  - the response property `allOf[#/components/schemas/entity-subscription]/_links/customer/href` became required for the status `200`
  - the response property `allOf[#/components/schemas/entity-subscription]/_links/customer/type` became required for the status `200`
  - the response property `allOf[#/components/schemas/entity-subscription]/_links/profile/href` became required for the status `200`
  - the response property `allOf[#/components/schemas/entity-subscription]/_links/profile/type` became required for the status `200`
- **2026-05-19** `7cab62b21830` — 1 info
  - added the non-success response with the status `429`
- **2026-05-12** `ef4b5a97b56a` — 2 info
  - the endpoint scheme security `advancedAccessToken` was added to the API
  - the endpoint scheme security `organizationAccessToken` was removed from the API

[Change history](https://skmtc.dev/mollie/apis/mollie-api/changes/v2/customers/:customerId/subscriptions/:subscriptionId/delete.md)

---

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