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

# List of subscriptions

`GET /v1/subscriptions/list`

## Request

- Base URL: `https://app.getswipe.in/api/partner`
- URL: `https://app.getswipe.in/api/partner/v1/subscriptions/list`
- Auth: HTTP bearer

**v1 is deprecated — use the v2 endpoint instead.** Lists subscriptions within a required date range, filterable by `status` and `customer_id`. Subscriptions are created through Create a document with `document_type=subscription`.

## 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

- ListSubscriptions
  - `success` boolean: Success flag
  - `message` string: Message
  - `error_code` string: Error code
  - `errors` object: Error details
  - `data` ListSubscriptionData
    - `transactions` SubscriptionDetails[]: 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` Invoice[]: 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

## Changes

- **2026-11-03** `0bcdbc62187b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getswipe/apis/swipeapi/changes/v1/subscriptions/list/get.md)

---

[API](https://skmtc.dev/getswipe/apis/swipeapi.md) - [All operations](https://skmtc.dev/getswipe/apis/swipeapi/llms.txt) - [OpenAPI document](https://skmtc.dev/getswipe/apis/swipeapi/revisions/0bcdbc62187b?raw)