---
title: "List all pauses for a subscription"
method: GET
path: "/subscriptions/{id}/pauses"
tags: ["Subscriptions"]
---

# List all pauses for a subscription

`GET /subscriptions/{id}/pauses`

Use when showing pause history for a subscription (e.g. support or audit). Returns all past and future pauses.

## Path parameters

- `id` string, required

## Response `200`

OK

- DtoListSubscriptionPausesResponse[]
  - `items` DtoSubscriptionPauseResponse[] — List of subscription pause objects @Description Array of subscription pauses
    - `created_at` string
    - `created_by` string
    - `environment_id` string — EnvironmentID is the environment identifier for the pause
    - `id` string — ID is the unique identifier for the subscription pause
    - `metadata` TypesMetadata
    - `original_period_end` string — OriginalPeriodEnd is the end of the billing period when the pause was created
    - `original_period_start` string — OriginalPeriodStart is the start of the billing period when the pause was created
    - `pause_end` string — PauseEnd is when the pause will end (null for indefinite)
    - `pause_mode` 'immediate' | 'scheduled' | 'period_end'
    - `pause_start` string — PauseStart is when the pause actually started
    - `pause_status` 'none' | 'active' | 'scheduled' | 'completed' | 'cancelled'
    - `reason` string — Reason is the reason for pausing
    - `resume_mode` 'immediate' | 'scheduled' | 'auto'
    - `resumed_at` string — ResumedAt is when the pause was actually ended (if manually resumed)
    - `status` 'published' | 'deleted' | 'archived'
    - `subscription_id` string — SubscriptionID is the identifier for the subscription
    - `tenant_id` string
    - `updated_at` string
    - `updated_by` string
  - `total` integer — Total number of pauses @Description Total count of subscription pauses in the response

## Other responses

- `400` — Invalid request
- `404` — Resource not found
- `500` — Server error

---

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