---
title: "List of Subscriptions"
method: GET
path: "/v2/subscriptions/list"
tags: ["Subscriptions V2"]
---

# List of Subscriptions

`GET /v2/subscriptions/list`

## Query parameters

- `start_date` string, required
- `end_date` string, required
- `status` 'all' | 'active' | 'expired' | 'error' | 'cancelled'
- `num_records` string
- `page` integer
- `customer_id` string

## Response `200`

Subscription List fetched successfully

- ListSubscriptionsV2
  - `success` boolean — Success flag
  - `message` string — Message
  - `error_code` string — Error code
  - `errors` object — Error details
  - `data` ListSubscriptionDataV2
    - `transactions` SubscriptionDetailsV2[] — List of subscriptions
      - `customer_id` string — Customer ID
      - `customer_name` string — Customer Name
      - `subscription_date` string — Subscription Date
      - `subscription_start_time` string — Subscription Start Time
      - `subscription_end_time` string — Subscription End Time
      - `sub_serial_number` string — Subscription Serial Number
      - `repeat_every` integer — Repeat Every
      - `repeat_unit` 'days' | 'weeks' | 'months' | 'years' — Repeat Unit
      - `status` 'active' | 'expired' | 'cancelled' — Subscription Status
      - `invoice_count` integer — Invoices Count
      - `invoices` InvoiceV2[] — List of invoices under this subscription
        - `name` string — Customer Name
        - `id` string — Customer ID
        - `serial_number` string — Serial Number
        - `status` 'paid' | 'pending' | 'cancelled' — Status
        - `hash_id` string — Hash ID
        - `record_time` string — Record Time
        - `total_amount` number — Total Amount
      - `last_created_invoice` string — Last Created Invoice Date
      - `upcoming_date` string — Upcoming Date
      - `hash_id` string — Hash ID
      - `total_amount` number — Total Amount
    - `total_records` integer — Total number of records

## Other responses

- `400` — Error in fetching subscription list
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/getswipe/apis/swipeapi.md) · [All operations](https://skmtc.dev/getswipe/apis/swipeapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getswipe/swipeapi/revisions/80fcaf1a3463/schema)