---
title: "List All Subscriptions"
method: GET
path: "/v1/subscriptions"
---

# List All Subscriptions

`GET /v1/subscriptions`

This API returns a list of subscriptions.

## Query parameters

- `limit` integer
- `page` integer
- `orderBy` string
- `sortedBy` 'asc' | 'desc'
- `include` 'customer' | 'discount'
- `status[in]` 'trial' | 'active' | 'pending' | 'passed_due' | 'paused' | 'canceled' | 'unpaid'
- `status[eq]` 'trial' | 'active' | 'pending' | 'passed_due' | 'canceled' | 'unpaid' | 'paused' | 'any'
- `created_at[intl]` integer
- `created_at[eq]` string
- `created_at[gte]` string
- `created_at[lte]` string
- `created_at[gt]` string
- `created_at[lt]` string
- `created_at[range]` object
- `payment_type[eq]` 'card' | 'ach'
- `plan` string
- `customer_id` string
- `excel` boolean

## Response `200`

200

- object
  - `data` object[]
    - `object` string
    - `id` string
    - `customer_id` string
    - `application_fee_percent` number, nullable
    - `billing_type` integer
    - `payment_due_days` integer, nullable
    - `cancel_at_period_end` integer
    - `canceled_at` integer, nullable
    - `current_period_end` integer, nullable
    - `current_period_start` integer, nullable
    - `days_until_due` integer, nullable
    - `plan_ref` string
    - `start_at` integer, nullable
    - `end_at` integer, nullable
    - `status` 'active' | 'trial' | 'pending' | 'passed_due' | 'paused' | 'unpaid' | 'canceled'
    - `tax_percent` number
    - `trial_end` integer, nullable
    - `trial_days` integer
    - `trial_start` integer, nullable
    - `created_at` integer, nullable
    - `updated_at` integer, nullable
    - `description` string, nullable
    - `payment_type` string, nullable
    - `paused_at` integer, nullable
    - `pause_end_at` integer, nullable
    - `resumed_at` integer, nullable
    - `pause_units_allowed` string[]
    - `plan` object
      - `data` object
        - `object` string
        - `plan_id` string
        - `amount` integer
        - `interval` string
        - `interval_count` integer
        - `name` string
        - `plan_description` string, nullable
        - `statement_descriptor` string, nullable
        - `trial_period_days` union
          - string
          - integer
        - `currency` string
        - `created_at` integer, nullable
        - `updated_at` integer, nullable
  - `meta` object
    - `include` string[]
    - `custom` unknown[]
      - unknown
    - `pagination` object
      - `total` integer
      - `count` integer
      - `per_page` integer
      - `current_page` integer
      - `total_pages` integer
      - `links` object

## Other responses

- `401` — 401

---

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