# Cancel Subscription

```
POST 
/subscriptions/:id/cancel
```

Cancels an active subscription, permanently stopping the billing cycle.

**Cancellation Effects**:

* The subscription status changes to `CANCELED`
* No further charges will be processed
* Access to subscription services typically ends immediately or at period end (depending on your business rules)

**Important Notes**:

* Cancellation is permanent and cannot be undone
* To restart service, a new subscription must be created
* Consider using `pauseAtPeriodEnd` or `cancelAtPeriodEnd` for softer transitions

Use this endpoint when a customer wishes to completely terminate their subscription.

## Request[​](#request "Direct link to request")

## Responses[​](#responses "Direct link to Responses")

* 200
* 400
* 401
* 404
* 422
* 500
* 503

A subscription object

The request is incorrect or could not be processed

Unauthorized error. Please check your auth credentials

The specified resource was not found

The request was well-formed but could not be processed due to semantic errors

Unexpected server error

The service is temporarily unavailable