---
title: "Terminate subscription"
method: POST
path: "/subscriptions/{subscriptionId}/terminate"
---

# Terminate subscription

`POST /subscriptions/{subscriptionId}/terminate`

Use this endpoint to terminate a subscription.

## Path parameters

- `subscriptionId` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `terminationType` 'paymentCancel' | 'userCancel' | 'publisherCancel' | 'policyViolation', required — One of following: <br> - `paymentCancel` - when terminating as a result of failed payment <br> - `userCancel` - when terminating as a result of user cancellation <br> - `publisherCancel` - when the decision to cancel comes from a publisher <br> - `policyViolation` - when terminating as a result of policy violation . <br><br> These values are used to drive churn analytics in the Cleeng dashboard.

## Response `200`

200

- object
  - `subscriptionId` integer
  - `paymentDetailsId` integer
  - `publisherId` integer
  - `customerId` integer
  - `status` string
  - `dateFrom` integer
  - `dateTo` integer
  - `nextPaymentAction` string
  - `nextPaymentActionDate` integer
  - `subscriptionExternalId` unknown
  - `offerId` string
  - `paymentCountry` string
  - `ipAddress` string
  - `inTrial` boolean
  - `couponCode` string
  - `pendingSwitchId` string
  - `externalProperties` object
  - `paymentMethodId` integer
  - `isExternallyManaged` boolean
  - `replacedBy` object
    - `subscriptionId` integer
    - `reason` string
    - `date` integer
  - `originatedFrom` object
    - `subscriptionId` integer
    - `reason` string
    - `date` integer
  - `source` string
  - `renewalCycle` object
    - `completed` integer
    - `unit` string
    - `amount` integer
  - `terminationType` string

## Other responses

- `404` — 404
- `422` — 422

---

[API](https://skmtc.net/cleeng/apis/mediastore-api.md) · [All operations](https://skmtc.net/cleeng/apis/mediastore-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cleeng/mediastore-api/versions/00cbfe7998a4/schema)