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

# Cancel subscription

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

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

> 🔑 Access with
>
> [API key](/reference/authentication)
>
> [Advanced access token with **subscriptions.write**](/reference/authentication)
>
> [OAuth access with **subscriptions.write**](/reference/authentication)

## 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.

---

[API](https://skmtc.net/mollie/apis/accepting-payments.md) · [All operations](https://skmtc.net/mollie/apis/accepting-payments/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/accepting-payments/revisions/4b45df3039ef/schema)