Read subscriptions for customer

This endpoint allows you to retrieve all subscriptions associated with a specific customer.

get/2026-04/customer/{customerIdentifier}/subscription

Request

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

Path parameters

customerIdentifierstring required

The unique identifier of the customer either customerShopifyId or emailAddress of the customer.

Query parameters

status'ACTIVE' | 'CANCELLED' | 'PAUSE' | 'EXPIRED'

Response

OK

successboolean
messagestring
codestring
pageInfounknown

Example response

{
  "success": true,
  "message": "Subscriptions fetched successfully",
  "data": [
    {
      "id": 20368414,
      "shopifyId": 25298665779,
      "totalLineItemPrice": 11.2,
      "totalLineItemDiscountedPrice": 11.2,
      "deliveryPrice": 8,
      "currencyCode": "USD",
      "nextBillingDateEpoch": 1788271500,
      "status": "ACTIVE",
      "billingAttemptSuccessCount": 2,
      "lastPaymentStatus": "FAILED",
      "paymentMethodId": 22176578,
      "createdAt": "2026-03-19T08:07:24.000Z",
      "customer": {
        "id": 443497692,
        "shopifyId": 9732955898163,
        "email": "vnitdevesh@gmail.com"
      },
      "billingPolicy": {
        "interval": "MONTH",
        "intervalCount": 1,
        "anchorDay": 1,
        "anchorType": "MONTHDAY"
      },
      "deliveryPolicy": {
        "interval": "MONTH",
        "intervalCount": 1
      },
      "deliveryMethod": {
        "code": "Standard",
        "title": "Standard"
      },
      "lines": [
        {
          "id": 58562316,
          "productShopifyId": 10116180541747,
          "variantShopifyId": 53140038615347,
          "sellingPlanShopifyId": 9114845491,
          "variantTitle": "Small",
          "productTitle": "Snack Box",
          "name": "Snack Box - Small",
          "price": "11.20",
          "basePrice": 14,
          "discountedPrice": 11.2,
          "quantity": 1
        }
      ],
      "shippingAddress": {
        "firstName": "Will",
        "lastName": "Smith",
        "phone": "+919994556780",
        "address1": "house no. 10, abc apartments",
        "city": "Plumville",
        "zip": "32801",
        "countryCode": "US",
        "provinceCode": "FL"
      },
      "billingAddress": {
        "zip": "32801",
        "city": "Plumville",
        "country": "US",
        "address1": "house no. 10, abc apartments",
        "province": "FL",
        "countryCode": "US",
        "provinceCode": "FL"
      },
      "updatedAt": "2026-08-04T14:03:40.000Z",
      "paymentMethod": {
        "id": 22176578,
        "type": "CustomerCreditCard",
        "card": {
          "brand": "bogus",
          "expiryYear": 30,
          "expiryMonth": 3,
          "lastDigits": "1"
        },
        "status": "safe",
        "source": "Credit card (Primary gateway)"
      },
      "originOrderShopifyId": 7036801188147
    }
  ],
  "code": "SUCCESS"
}

Changes

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