---
title: "List subscriptions"
method: GET
path: "/2026-04/subscription"
---

# List subscriptions

`GET /2026-04/subscription`

## Request

- Base URL: `https://api.loopsubscriptions.com/storefront`
- URL: `https://api.loopsubscriptions.com/storefront/2026-04/subscription`
- Auth: API key in header `Authorization`

This endpoint allows you to retrieve a list of all subscriptions for the customer.

## Query parameters

- `status` 'ACTIVE' | 'PAUSED' | 'CANCELLED' | 'EXPIRED'

## Response `200`

Subscriptions list fetched successfully

- object
  - `success` boolean
  - `message` string
  - `data` object[]
    - `id` integer
    - `shopifyId` integer
    - `discounts` object[]
      - `shopifyId` string
      - `title` string
      - `isActive` boolean
      - `type` string
      - `value` object
        - `percentage` integer
      - `orderLimit` unknown
      - `usageCount` integer
      - `targetType` string
    - `totalLineItemPrice` number
    - `orderNote` unknown
    - `totalLineItemDiscountedPrice` number
    - `deliveryPrice` integer
    - `currencyCode` string
    - `cancellationComment` unknown
    - `cancellationReason` unknown
    - `status` string
    - `attributes` object[]
    - `nextBillingDate` string
    - `nextBillingDateEpoch` integer
    - `billingAttemptSuccessCount` integer
    - `paymentMethodId` integer
    - `chargeOffsetDays` integer
    - `lastPaymentStatus` string
    - `createdAt` string
    - `isPrepaid` boolean
    - `lastInventoryAction` unknown
    - `billingPolicy` object
      - `interval` string
      - `intervalCount` integer
      - `minCycles` unknown
      - `maxCycles` unknown
    - `deliveryPolicy` object
      - `interval` string
      - `intervalCount` integer
    - `shippingAddress` object
      - `firstName` string
      - `lastName` string
      - `phone` unknown
      - `company` unknown
      - `address1` string
      - `address2` unknown
      - `city` string
      - `zip` string
      - `provinceCode` string
      - `countryCode` string
    - `lines` object[]
      - `id` integer
      - `productShopifyId` integer
      - `variantShopifyId` integer
      - `variantTitle` unknown
      - `productTitle` string
      - `name` string
      - `price` string
      - `basePrice` integer
      - `discountedPrice` number
      - `quantity` integer
      - `sku` string
      - `isOneTimeAdded` boolean
      - `isOneTimeRemoved` boolean
      - `bundleTransactionId` integer
      - `attributes` object[]
        - `key` string
        - `value` string
      - `weightInGrams` integer
      - `image` unknown
    - `deliveryMethod` object
      - `code` string
      - `title` string
  - `code` string
  - `pageInfo` unknown

## Changes

- **2026-11-03** `1ff6a5700816`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/loopwork/apis/storefront-api/changes/2026-04/subscription/get.md)

---

[API](https://skmtc.dev/loopwork/apis/storefront-api.md) - [All operations](https://skmtc.dev/loopwork/apis/storefront-api/llms.txt) - [OpenAPI document](https://skmtc.dev/loopwork/apis/storefront-api/revisions/1ff6a5700816?raw)