---
title: "List subscriptions"
method: GET
path: "/v1/subscriptions"
tags: ["Subscriptions"]
---

# List subscriptions

`GET /v1/subscriptions`

## Response `200`

Success

- object — List of subscriptions
  - `status` 'SUCCEEDED', required
  - `data` object[], required
    - `id` string, required
    - `clientReferenceId` string, required
    - `status` 'INCOMPLETE' | 'TRIALING' | 'SCHEDULED' | 'ACTIVE' | 'DISCOUNTED_TRIALING' | 'GRACE_PERIOD' | 'CANCELED' | 'SUSPENDED' | 'INCOMPLETE_EXPIRED', required
    - `priceId` string, required
    - `productId` string, required
    - `customerId` string, required
    - `amountStr` string, required
    - `unitAmount` number, required
    - `currency` string, required
    - `billingCycleConfig` object, required
      - `interval` 'hour' | 'day' | 'week' | 'month' | 'year', required
      - `frequency` number, required
    - `merchantId` string, required
    - `livemode` boolean, required
    - `defaultPaymentMethodId` string
    - `defaultPaymentMethodType` string
    - `billingCycleAnchor` number
    - `canceledAt` number — The date the subscription was canceled. If the subscription was canceled with cancelAtPeriodEnd=true, this reflects the time of the most recent cancel request, not the end of the subscription period when the subscription is automatically moved to a canceled state.
    - `canceledBy` string
    - `lastSuccessfulPaymentId` string
    - `lastSuccessfulInvoiceId` string
    - `firstSuccessfulPaymentId` string
    - `trial` unknown
    - `startAt` number
    - `fallbackBillingEmail` string
    - `successReturnUrl` string
    - `failReturnUrl` string
    - `cancelAtPeriodEnd` boolean — If true, the subscription is scheduled to be canceled at the end of the current billing period rather than immediately.
    - `cancelAt` number — Unix timestamp (ms) of the end of the current billing period when the subscription will be canceled. Only present when cancelAtPeriodEnd is true.
    - `preferredPaymentMethods` string[]
    - `phases` object[]
      - `cycleCount` number, required
      - `price` object, required
        - `id` string
        - `unitAmount` number, required
        - `currency` 'USD' | 'AUD' | 'CAD' | 'CHF' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'JPY' | 'NOK' | 'NZD' | 'PLN' | 'SEK' | 'SGD' | 'TWD' | 'KRW' | 'SOL' | 'USDC' | 'USDT' | 'HONEY' | 'EURC', required
        - `billingCycleConfig` object, required
          - `interval` 'hour' | 'day' | 'week' | 'month' | 'year', required
          - `frequency` number, required
    - `gracePeriodDays` number
  - `hasMore` boolean

## Other responses

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

---

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