---
title: "List products"
method: GET
path: "/v2/products"
tags: ["Products"]
---

# List products

`GET /v2/products`

Returns a paginated list of products with their prices. Use the nextCursorToken from the response as cursorToken in the next request to page through results. When hasMore is false, you have reached the last page.

## Query parameters

- `limit` integer — Number of products to return per page (1–50, default 20)
- `cursorToken` string — Value of nextCursorToken from a previous response to fetch the next page

## Response `200`

Success

- object — List of products
  - `status` 'SUCCEEDED', required
  - `data` object[], required
    - `id` string
    - `createdAt` number
    - `updatedAt` number
    - `defaultPriceId` string
    - `clientProductId` string
    - `description` string
    - `displayName` string, required
    - `image` string
    - `livemode` boolean, required
    - `merchantId` string, required
    - `status` 'ACTIVE' | 'INACTIVE' | 'PENDING' | 'DELETED', required
    - `type` 'SUBSCRIPTION' | 'REGULAR', required
    - `prices` object[], required
      - `id` string
      - `createdAt` number
      - `updatedAt` number
      - `currency` 'USD' | 'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'JPY' | 'NOK' | 'NZD' | 'PLN' | 'SEK' | 'SGD' | 'TWD' | 'KRW', required
      - `amountStr` string, required
      - `status` 'ACTIVE' | 'INACTIVE' | 'DELETED', required
      - `productId` string, required
      - `type` 'ONE_TIME' | 'RECURRING', required
      - `livemode` boolean, required
      - `billingCycleConfig` object
        - `interval` 'hour' | 'day' | 'week' | 'month' | 'year', required
        - `frequency` number, required
      - `unitAmount` number, required
  - `hasMore` boolean
  - `nextCursorToken` string — Pass this value as cursorToken in the next request to fetch the next page. Absent when there are no more items.

## Other responses

- `400` — Bad request
- `401` — Unauthorized

---

[API](https://skmtc.net/breeze/apis/breeze-api.md) · [All operations](https://skmtc.net/breeze/apis/breeze-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/breeze/breeze-api/versions/8911892bdf29/schema)