---
title: "List Subscriptions"
method: GET
path: "/v0/price-tracking/subscriptions"
tags: ["price-tracking"]
---

# List Subscriptions

`GET /v0/price-tracking/subscriptions`

List your active price tracking subscriptions.

## Query parameters

- `cursor` string, nullable — Pagination cursor
- `limit` integer — Max results (1-100)

## Response `200`

Successful Response

- PaginatedSubscriptionsResponse
  - `items` SubscriptionResponse[], required
    - `canonical_product_id` string, required
    - `subscription_status` 'active' | 'cancelled', required
    - `created_at` string, date-time, required
  - `next_cursor` string, nullable

## Other responses

- `401` — Unauthorized - Invalid or missing authentication
- `402` — Payment required
- `422` — Validation Error
- `500` — Internal Server Error

## Changes

- **2026-05-21** `48ea59b2e819` — 4 info
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `401`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `402`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `422`
  - added `subschema #1, subschema #2` to the `detail` response property `anyOf` list for the response status `500`
- **2026-03-03** `4a56c45ff30e` — 1 breaking, 2 warning, 3 info
  - removed the required property `subscriptions` from the response with the `200` status
  - deleted the `query` request parameter `page_token`
  - removed the optional property `next_page_token` from the response with the `200` status
  - added the new optional `query` request parameter `cursor`
  - …2 more

[Change history](https://skmtc.dev/channel3-ai/apis/fastapi/changes/v0/price-tracking/subscriptions/get.md)

---

[API](https://skmtc.dev/channel3-ai/apis/fastapi.md) · [All operations](https://skmtc.dev/channel3-ai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/channel3-ai/fastapi/revisions/981d371bd83e/schema)