> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creptapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Subscriptions

Paginated subscriptions for your business and environment, newest first.

## Request authentication

This endpoint requires a **Secret Key** (`sk_...`).

## Query parameters

<ResponseField name="status" type="string">
  `trialing`, `active`, `past_due`, `paused`, `canceled` or `expired`.
</ResponseField>

<ResponseField name="plan" type="string">
  Only subscriptions on this plan.
</ResponseField>

<ResponseField name="customer" type="string">
  Only subscriptions belonging to this customer.
</ResponseField>

<ResponseField name="page" type="integer" default="1">
  The page to return.
</ResponseField>

<ResponseField name="limit" type="integer" default="15">
  How many per page.
</ResponseField>