Get selling plans for products

Retrieves all selling plans (subscription plans) associated with a set of products. This endpoint is useful for determining which subscription options are available for specific products.

Full behavior, validation rules, and side effects

Selling Plan Information:

• Selling plan ID and name
• Billing and delivery frequencies
• Pricing policies (discounts)
• Plan description and options
• Product associations

Use Cases:

• Display subscription options on product pages
• Validate subscription plan availability
• Build subscription plan selector UI
• Sync plan data across systems

Request:

• Accepts multiple product IDs as comma-separated values
• Returns aggregated selling plans from all products

Authentication: Requires valid api_key parameter

GET /subscriptions/cp/api/data/products-selling-plans

Get selling plans for products

cURL

curl --request GET \
  --url https://www.myshop.com/apps/subscriptions/cp/api/data/products-selling-plans

200

[
  {
    "get__typename": "<string>",
    "id": "<string>",
    "sellingPlanId": "<string>",
    "sellingPlanName": "<string>",
    "productId": "<string>",
    "sku": "<string>",
    "title": "<string>",
    "variantId": "<string>",
    "quantity": 123,
    "customAttributes": [
      {
        "get__typename": "<string>",
        "key": "<string>",
        "value": "<string>"
      }
    ],
    "lineDiscountedPrice": {
      "get__typename": "<string>",
      "amount": {}
    },
    "variantImage": {
      "get__typename": "<string>",
      "transformedSrc": {}
    },
    "variantTitle": "<string>",
    "currentPrice": {
      "get__typename": "<string>",
      "amount": {}
    },
    "discountAllocations": [
      {
        "get__typename": "<string>",
        "amount": {
          "get__typename": "<string>",
          "amount": {}
        },
        "discount": {
          "get__typename": "<string>"
        }
      }
    ],
    "pricingPolicy": {
      "get__typename": "<string>",
      "basePrice": {
        "get__typename": "<string>",
        "amount": {}
      },
      "cycleDiscounts": [
        {
          "get__typename": "<string>",
          "afterCycle": 123,
          "computedPrice": {
            "get__typename": "<string>",
            "amount": {}
          },
          "adjustmentValue": {
            "get__typename": "<string>"
          }
        }
      ]
    },
    "taxable": true
  }
]

Query Parameters

productIds · integer<int64>[] · required

Product IDs

Response

200

*/*

Selling plans retrieved successfully

get__typename · string

id · string

sellingPlanId · string

sellingPlanName · string

productId · string

sku · string

title · string

variantId · string

quantity · integer<int32>

customAttributes · object[]

Show child attributes

lineDiscountedPrice · object

Show child attributes

variantImage · object

Show child attributes

variantTitle · string

currentPrice · object

Show child attributes

discountAllocations · object[]

Show child attributes

pricingPolicy · object

Show child attributes

taxable · boolean