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

# List Subscriptions

`GET /v5/subscriptions`

Retrieve a list of all subscriptions.

## Query parameters

- `cursor` integer
- `per_page` integer

## Response `200`

Success

- object
  - `subscriptions` SubscriptionResponse[]
    - `object` 'subscription', required — Resource type identifier
    - `id` string, required — Subscription ID
    - `start_date` string, date-time, nullable — Subscription start date in UTC ISO 8601 format
    - `next_billing_date` string, date-time, nullable — Next billing date in UTC ISO 8601 format
    - `amount` string — Subscription amount
    - `customer_vault_id` string — Customer vault ID associated with the subscription
    - `delayed_condition` string — Delayed condition
    - `paused_subscription` 0 | 1 — Whether the subscription is paused (0 = active, 1 = paused)
    - `plan` object, nullable — Associated plan
      - `id` string — Plan ID
      - `plan_name` string — Plan name
      - `plan_amount` string — Plan amount
      - `plan_payments` string — Number of payments (0 = until canceled)
      - `day_frequency` string — Day frequency (0 if not applicable)
      - `month_frequency` string — Month frequency (0 if not applicable)
      - `day_of_month` string — Day of month (empty if not applicable)
  - `next_cursor` integer, nullable — Cursor for the next page. Use this value in the cursor parameter for the next request. Null if there are no more results.
  - `per_page` integer — Number of subscriptions per page

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/revisions/45c2ecda3685/schema)