Read all subscriptions

This endpoint allows you to retrieves a list of all subscriptions.

get/2026-04/subscription

Request

  • Base URL
    https://api.loopsubscriptions.com/admin
  • URL
    https://api.loopsubscriptions.com/admin/2026-04/subscription
  • Auth
    API key in header X-Loop-Token

Query parameters

afterCursorstring

The cursor returned in the previous response. Use the nextCursor value from that response to fetch the next page of results.

pageSizeinteger

The number of records to return per page. Maximum - 100

updatedAtStartEpochinteger

Start of the time range (in epoch) for filtering customers based on their last update time.

updatedAtEndEpochinteger

End of the time range (in epoch) for filtering customers based on their last update time.

status'ACTIVE' | 'PAUSED' | 'CANCELLED' | 'EXPIRED'
nextBillingStartEpochinteger

Start of the time range (in epoch) for filtering subscriptions based on their next billing date.

nextBillingEndEpochinteger

End of the time range (in epoch) for filtering subscriptions based on their next billing date.

lastInventoryAction'SKIPPED' | 'DELAYED' | 'PARTIAL_BILLING'

Filters subscriptions by their last order status (e.g., Skipped, delayed or partially billed)

createdAtStartEpochinteger

Start of the time range (in epoch) for filtering subscriptions based on their createdAt date.

createdAtEndEpochinteger

End of the time range (in epoch) for filtering subscriptions based on their createdAt date.

lastPaymentStatus'SUCCESS' | 'FAILED'

Filter subscriptions by their last order payment status. This filter is used to filter subscriptions that are in dunning.

Response

OK

successboolean
messagestring
codestring

Example response

{
  "success": true,
  "message": "Subscriptions fetched successfully",
  "data": [
    {
      "id": 35618663,
      "shopifyId": 33878704435,
      "createdAt": "2026-08-26T06:17:50.000Z",
      "updatedAt": "2026-08-26T10:08:54.000Z",
      "totalLineItemPrice": 10.5,
      "totalLineItemDiscountedPrice": 10.5,
      "deliveryPrice": 8,
      "currencyCode": "USD",
      "status": "ACTIVE",
      "attributes": [
        {
          "key": "split_source_subscription_id",
          "value": "30650760"
        }
      ],
      "nextBillingDateEpoch": 1790258700,
      "chargeOffset": 2,
      "lastPaymentStatus": "SUCCESS",
      "deliveryMethod": {
        "code": "Standard",
        "title": "Standard"
      },
      "billingPolicy": {
        "interval": "MONTH",
        "intervalCount": 1
      },
      "deliveryPolicy": {
        "interval": "MONTH",
        "intervalCount": 1
      },
      "shippingAddress": {
        "firstName": "Will",
        "lastName": "Smith",
        "phone": "+919994556780",
        "address1": "House 5",
        "city": "Ithaca",
        "zip": "14853",
        "countryCode": "US",
        "provinceCode": "NY"
      },
      "lines": [
        {
          "id": 88690513,
          "productShopifyId": 10172079341875,
          "variantShopifyId": 53455454142771,
          "sellingPlanShopifyId": 9603711283,
          "sellingPlanName": "Deliver every month",
          "sellingPlanGroupName": "Subscribe for monthly delivery",
          "sellingPlanGroupMerchantCode": "Subscribe for monthly delivery",
          "variantTitle": "Varient 111 / White",
          "productTitle": "Product box",
          "name": "Product box - Varient 111 / White",
          "price": "10.50",
          "basePrice": 15,
          "discountedPrice": 10.5,
          "quantity": 1,
          "variantImage": "https://cdn.shopify.com/s/files/1/0981/0798/2131/files/premium-quality-pure-white-product-package-box-with-natural-light-ultra-clear-digital-render-free-photo.jpg?v=1778491911"
        }
      ],
      "customer": {
        "id": 443497692,
        "shopifyId": 9732955898163,
        "email": "vnitdevesh@gmail.com"
      },
      "customerPaymentMethodId": 22176578,
      "billingAddress": {
        "zip": "32801",
        "city": "Plumville",
        "country": "United States",
        "address1": "house no. 10, abc apartments",
        "province": "Florida",
        "countryCode": "US",
        "provinceCode": "FL"
      },
      "paymentMethod": {
        "id": 22176578,
        "type": "CustomerCreditCard",
        "card": {
          "brand": "bogus",
          "expiryYear": 30,
          "expiryMonth": 3,
          "lastDigits": "1"
        },
        "status": "safe",
        "source": "Credit card (Primary gateway)"
      }
    }
  ],
  "code": "SUCCESS",
  "pageInfo": {
    "hasNextPage": true,
    "nextCursor": "eyJsYXN0SWQiOjM1MDkxNzYyLCJlbnRpdHkiOiJzdWJzY3JpcHRpb24iLCJkb21haW5TbHVnIjoiZGV2ZXNoLW9uYm9hcmRpbmcifQ=="
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.