---
title: "List Subscription Freezes"
method: GET
path: "/api/v2/subscriptions/{subscription_id}/freeze"
tags: ["Subscriptions"]
---

# List Subscription Freezes

`GET /api/v2/subscriptions/{subscription_id}/freeze`

List all freeze periods for a specific subscription.

## Path parameters

- `subscription_id` string, uuid, required — Unique identifier (UUID) of the subscription

## Query parameters

- `page` integer — Page number, defaults to 1.
- `limit` integer — Size of a page, defaults to 10. Maximum is 100.
- `sort_field` string, nullable — Field to sort by, e.g., 'amount', 'scheduled_on'
- `sort_direction` string, nullable — Sorting direction ('asc' or 'desc')

## Response `200`

Successful Response

- ListResourceFreezeSubscriptionBase
  - `data` FreezeSubscriptionBase[]
    - `created_at` string, date-time — Creation timestamp of the object.
    - `updated_at` string, date-time, nullable — Last modification timestamp of the object.
    - `id` string, uuid
    - `freeze_start_datetime` string, date-time
    - `freeze_end_datetime` string, date-time, nullable
    - `notes` string, nullable
    - `subscription_id` string, uuid
    - `invoice_id` string, uuid
    - `duration` integer, nullable
  - `pagination` Pagination
    - `total_count` integer
    - `max_page` integer
    - `current_page` integer
    - `limit` integer
    - `has_next_page` boolean
    - `has_previous_page` boolean

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/streampay/apis/stream-app.md) · [All operations](https://skmtc.dev/streampay/apis/stream-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/streampay/stream-app/revisions/515eeea7d260/schema)