---
title: "Pause subscription"
method: POST
path: "/subscriptions/{subscriptionId}/pause"
---

# Pause subscription

`POST /subscriptions/{subscriptionId}/pause`

Use this endpoint to pause a subscription. You can only pause active and canceled subscriptions (you cannot pause in-trial or terminated subscriptions). <br><br> Transition from active state to pause  is tied to subscription anniversary date (the pause will start with a new billing cycle).

## Path parameters

- `subscriptionId` integer, required

## Request body

- object
  - `pauseDate` string, required — Currently only "anniversary-date" available.
  - `resumesAfterBillingCycles` integer, required — The number of cycles after which the subscription resumes after a pause. Resume date is calculated based on this.

## 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
  - `latestPaymentExternalId` string
  - `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` unknown
  - `pause` object
    - `requestedAt` integer
    - `pauseDate` integer
    - `resumeDate` integer
    - `failedResumes` integer[]

## Other responses

- `400` — 400
- `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)