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

# List Subscriptions

`GET /v0/price-tracking/subscriptions`

## Request

- Base URL: `https://api.trychannel3.com`
- URL: `https://api.trychannel3.com/v0/price-tracking/subscriptions`
- Auth: API key in header `x-api-key`

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

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

---

[API](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api.md) - [All operations](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/llms.txt) - [OpenAPI document](https://skmtc.dev/channel3-ai/apis/channel3-typescript-api/revisions/f9f7b422ab5d?raw)