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

# List Subscriptions

> List the merchant store subscriptions (newest first).

Lists every subscription row for the merchant — current and historical —
ordered by `createdAt` descending.

**Required scope:** `read_billing`

## Response

<ResponseField name="data" type="object">
  <Expandable title="subscriptions">
    <ResponseField name="subscriptions" type="array">
      Subscription rows. Each entry contains: `subscriptionId`, `planType`,
      `planDuration`, `amount`, `currency`, `status` (`active`, `expired`,
      `cancelled`, `trialing`, `past_due`), `subscriptionEndingDate`,
      `subscriptionCancelationDate`, `paymentGateway`, `invoiceId`,
      `createdAt`, `updatedAt`.
    </ResponseField>

    <ResponseField name="count" type="number">Total subscriptions returned.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": null,
    "data": {
      "subscriptions": [
        {
          "subscriptionId": "7f04abcb-5370-4e61-9857-5d477313a5e9",
          "planType": "Trial",
          "planDuration": null,
          "amount": "0.00",
          "currency": "INR",
          "status": "expired",
          "subscriptionEndingDate": "2026-02-15T18:19:04.275Z",
          "subscriptionCancelationDate": null,
          "paymentGateway": "Stripe",
          "invoiceId": null,
          "createdAt": "2026-02-08T18:19:04.276Z",
          "updatedAt": "2026-02-25T20:01:42.881Z"
        }
      ],
      "count": 1
    },
    "pagination": null
  }
  ```
</ResponseExample>