# Get subscription group by ID

Retrieves detailed information about a specific subscription group (selling plan group) by its ID. This endpoint provides complete configuration details for a single subscription group.

Response includes:
- Group name and configuration
- All selling plans with complete details
- Product and variant assignments
- Discount tiers and configurations
- Free trial settings
- Member restrictions
- Delivery and billing frequencies

Use Cases:
- Display detailed subscription options for editing
- Verify configuration before updates
- Debug subscription issues
- Integration with external systems

Authentication: Requires valid X-API-Key header

Endpoint: GET /api/external/v2/subscription-groups/{id}
Version: 0.0.1

## Path parameters:

  - `id` (integer, required)
    Subscription group ID (numeric ID)
    Example: 123456789

## Header parameters:

  - `X-API-Key` (string, required)
    API Key for authentication
    Example: "sk_live_1234567890abcdef"

## Query parameters:

  - `api_key` (string)
    API Key (Deprecated - Use X-API-Key header instead)

## Response 200 fields (application/json):

  - `id` (integer)

  - `productCount` (integer)

  - `productVariantCount` (integer)

  - `subscriptionPlans` (array)

  - `subscriptionPlans.frequencyCount` (integer)

  - `subscriptionPlans.frequencyInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.billingFrequencyCount` (integer)

  - `subscriptionPlans.payAsYouGoPrepaidBillingFrequencyCount` (integer)

  - `subscriptionPlans.billingFrequencyInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.frequencyName` (string)

  - `subscriptionPlans.frequencyDescription` (string)

  - `subscriptionPlans.discountOffer` (number)

  - `subscriptionPlans.discountOffer2` (number)

  - `subscriptionPlans.afterCycle1` (integer)

  - `subscriptionPlans.afterCycle2` (integer)

  - `subscriptionPlans.discountType` (string)
    Enum: "PERCENTAGE", "FIXED", "PRICE"

  - `subscriptionPlans.discountType2` (string)
    Enum: "PERCENTAGE", "FIXED", "PRICE"

  - `subscriptionPlans.discountEnabled` (boolean)

  - `subscriptionPlans.discountEnabled2` (boolean)

  - `subscriptionPlans.discountEnabledMasked` (boolean)

  - `subscriptionPlans.discountEnabled2Masked` (boolean)

  - `subscriptionPlans.frequencyType` (string)
    Enum: "ON_PURCHASE_DAY", "ON_SPECIFIC_DAY"

  - `subscriptionPlans.specificDayValue` (integer)

  - `subscriptionPlans.specificMonthValue` (integer)

  - `subscriptionPlans.specificDayEnabled` (boolean)

  - `subscriptionPlans.maxCycles` (integer)

  - `subscriptionPlans.minCycles` (integer)

  - `subscriptionPlans.cutOff` (integer)

  - `subscriptionPlans.prepaidFlag` (string)

  - `subscriptionPlans.idNew` (string)

  - `subscriptionPlans.planType` (string)
    Enum: "PAY_AS_YOU_GO", "PREPAID", "ADVANCED_PREPAID", "PAY_AS_YOU_GO_PREPAID"

  - `subscriptionPlans.deliveryPolicyPreAnchorBehavior` (string)
    Enum: "ASAP", "NEXT", "$UNKNOWN"

  - `subscriptionPlans.freeTrialEnabled` (boolean)

  - `subscriptionPlans.freeTrialCount` (integer)

  - `subscriptionPlans.freeTrialInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.memberOnly` (boolean)

  - `subscriptionPlans.nonMemberOnly` (boolean)

  - `subscriptionPlans.memberInclusiveTags` (string)

  - `subscriptionPlans.memberExclusiveTags` (string)

  - `subscriptionPlans.formFieldJson` (string)

  - `subscriptionPlans.upcomingOrderEmailBuffer` (integer)

  - `subscriptionPlans.frequencySequence` (integer)

  - `subscriptionPlans.groupName` (string)

  - `subscriptionPlans.groupId` (integer)

  - `subscriptionPlans.repeatingCycle` (boolean)

  - `subscriptionPlans.repeatingNumberOfCycle` (integer)

  - `subscriptionPlans.keepOriginalNextBillingDateAfterTrial` (boolean)

  - `subscriptionPlans.defaultSelectedPlan` (boolean)

  - `subscriptionPlans.inventoryPolicyReserve` (string)
    Enum: "ON_FULFILLMENT", "ON_SALE", "$UNKNOWN"

  - `subscriptionPlans.appstleCycles` (array)

  - `subscriptionPlans.appstleCycles.afterCycle` (integer)
    The billing cycle number after which this pricing applies
    Example: 3

  - `subscriptionPlans.appstleCycles.discountType` (string)
    Type of discount to apply in pricing cycles
    Enum: "PERCENTAGE", "FIXED", "PRICE", "SHIPPING", "FREE_PRODUCT", "PERCENTAGE", "FIXED", "PRICE", "SHIPPING", "FREE_PRODUCT"

  - `subscriptionPlans.appstleCycles.value` (number)
    Discount value. For PERCENTAGE: 0-100 (e.g., 10 for 10% off). For FIXED: amount to subtract from price. For PRICE: new fixed price. For SHIPPING: shipping discount amount. For FREE_PRODUCT: not used (set freeVariantId or freeProductHandle instead)
    Example: 10

  - `subscriptionPlans.appstleCycles.freeVariantId` (integer)
    Variant ID of a free product to add when discountType is FREE_PRODUCT
    Example: 42549172011164

  - `subscriptionPlans.appstleCycles.freeProductHandle` (string)
    Product handle of a free product to add when discountType is FREE_PRODUCT
    Example: "free-gift-product"

  - `subscriptionPlans.appstleCycles.repeatingCycle` (boolean)
    Whether this pricing should repeat for subsequent cycles
    Example: true

  - `subscriptionPlans.appstleCycles.repeatingNumberOfCycle` (integer)
    Number of cycles to repeat this pricing for when repeatingCycle is true
    Example: 6

  - `subscriptionPlans.appstleCycles.preventDuplicationFreeProduct` (boolean)
    Prevent adding duplicate free products if already in cart
    Example: true

  - `productIds` (string)

  - `productId` (string)

  - `variantIds` (string)

  - `accessoryProductIds` (string)

  - `updateProducts` (object)

  - `updateProducts.allProduct` (boolean)

  - `updateProducts.collectionId` (string)

  - `updateProducts.deleteAllProduct` (boolean)

  - `updateProducts.productDetails` (string)

  - `updateProducts.variantDetails` (string)

  - `deleteProducts` (object)

  - `translations` (string)

## Response 401 fields (*/*):

  - `id` (integer)

  - `productCount` (integer)

  - `productVariantCount` (integer)

  - `subscriptionPlans` (array)

  - `subscriptionPlans.frequencyCount` (integer)

  - `subscriptionPlans.frequencyInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.billingFrequencyCount` (integer)

  - `subscriptionPlans.payAsYouGoPrepaidBillingFrequencyCount` (integer)

  - `subscriptionPlans.billingFrequencyInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.frequencyName` (string)

  - `subscriptionPlans.frequencyDescription` (string)

  - `subscriptionPlans.discountOffer` (number)

  - `subscriptionPlans.discountOffer2` (number)

  - `subscriptionPlans.afterCycle1` (integer)

  - `subscriptionPlans.afterCycle2` (integer)

  - `subscriptionPlans.discountType` (string)
    Enum: "PERCENTAGE", "FIXED", "PRICE"

  - `subscriptionPlans.discountType2` (string)
    Enum: "PERCENTAGE", "FIXED", "PRICE"

  - `subscriptionPlans.discountEnabled` (boolean)

  - `subscriptionPlans.discountEnabled2` (boolean)

  - `subscriptionPlans.discountEnabledMasked` (boolean)

  - `subscriptionPlans.discountEnabled2Masked` (boolean)

  - `subscriptionPlans.frequencyType` (string)
    Enum: "ON_PURCHASE_DAY", "ON_SPECIFIC_DAY"

  - `subscriptionPlans.specificDayValue` (integer)

  - `subscriptionPlans.specificMonthValue` (integer)

  - `subscriptionPlans.specificDayEnabled` (boolean)

  - `subscriptionPlans.maxCycles` (integer)

  - `subscriptionPlans.minCycles` (integer)

  - `subscriptionPlans.cutOff` (integer)

  - `subscriptionPlans.prepaidFlag` (string)

  - `subscriptionPlans.idNew` (string)

  - `subscriptionPlans.planType` (string)
    Enum: "PAY_AS_YOU_GO", "PREPAID", "ADVANCED_PREPAID", "PAY_AS_YOU_GO_PREPAID"

  - `subscriptionPlans.deliveryPolicyPreAnchorBehavior` (string)
    Enum: "ASAP", "NEXT", "$UNKNOWN"

  - `subscriptionPlans.freeTrialEnabled` (boolean)

  - `subscriptionPlans.freeTrialCount` (integer)

  - `subscriptionPlans.freeTrialInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.memberOnly` (boolean)

  - `subscriptionPlans.nonMemberOnly` (boolean)

  - `subscriptionPlans.memberInclusiveTags` (string)

  - `subscriptionPlans.memberExclusiveTags` (string)

  - `subscriptionPlans.formFieldJson` (string)

  - `subscriptionPlans.upcomingOrderEmailBuffer` (integer)

  - `subscriptionPlans.frequencySequence` (integer)

  - `subscriptionPlans.groupName` (string)

  - `subscriptionPlans.groupId` (integer)

  - `subscriptionPlans.repeatingCycle` (boolean)

  - `subscriptionPlans.repeatingNumberOfCycle` (integer)

  - `subscriptionPlans.keepOriginalNextBillingDateAfterTrial` (boolean)

  - `subscriptionPlans.defaultSelectedPlan` (boolean)

  - `subscriptionPlans.inventoryPolicyReserve` (string)
    Enum: "ON_FULFILLMENT", "ON_SALE", "$UNKNOWN"

  - `subscriptionPlans.appstleCycles` (array)

  - `subscriptionPlans.appstleCycles.afterCycle` (integer)
    The billing cycle number after which this pricing applies
    Example: 3

  - `subscriptionPlans.appstleCycles.discountType` (string)
    Type of discount to apply in pricing cycles
    Enum: "PERCENTAGE", "FIXED", "PRICE", "SHIPPING", "FREE_PRODUCT", "PERCENTAGE", "FIXED", "PRICE", "SHIPPING", "FREE_PRODUCT"

  - `subscriptionPlans.appstleCycles.value` (number)
    Discount value. For PERCENTAGE: 0-100 (e.g., 10 for 10% off). For FIXED: amount to subtract from price. For PRICE: new fixed price. For SHIPPING: shipping discount amount. For FREE_PRODUCT: not used (set freeVariantId or freeProductHandle instead)
    Example: 10

  - `subscriptionPlans.appstleCycles.freeVariantId` (integer)
    Variant ID of a free product to add when discountType is FREE_PRODUCT
    Example: 42549172011164

  - `subscriptionPlans.appstleCycles.freeProductHandle` (string)
    Product handle of a free product to add when discountType is FREE_PRODUCT
    Example: "free-gift-product"

  - `subscriptionPlans.appstleCycles.repeatingCycle` (boolean)
    Whether this pricing should repeat for subsequent cycles
    Example: true

  - `subscriptionPlans.appstleCycles.repeatingNumberOfCycle` (integer)
    Number of cycles to repeat this pricing for when repeatingCycle is true
    Example: 6

  - `subscriptionPlans.appstleCycles.preventDuplicationFreeProduct` (boolean)
    Prevent adding duplicate free products if already in cart
    Example: true

  - `productIds` (string)

  - `productId` (string)

  - `variantIds` (string)

  - `accessoryProductIds` (string)

  - `updateProducts` (object)

  - `updateProducts.allProduct` (boolean)

  - `updateProducts.collectionId` (string)

  - `updateProducts.deleteAllProduct` (boolean)

  - `updateProducts.productDetails` (string)

  - `updateProducts.variantDetails` (string)

  - `deleteProducts` (object)

  - `translations` (string)

## Response 403 fields (*/*):

  - `id` (integer)

  - `productCount` (integer)

  - `productVariantCount` (integer)

  - `subscriptionPlans` (array)

  - `subscriptionPlans.frequencyCount` (integer)

  - `subscriptionPlans.frequencyInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.billingFrequencyCount` (integer)

  - `subscriptionPlans.payAsYouGoPrepaidBillingFrequencyCount` (integer)

  - `subscriptionPlans.billingFrequencyInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.frequencyName` (string)

  - `subscriptionPlans.frequencyDescription` (string)

  - `subscriptionPlans.discountOffer` (number)

  - `subscriptionPlans.discountOffer2` (number)

  - `subscriptionPlans.afterCycle1` (integer)

  - `subscriptionPlans.afterCycle2` (integer)

  - `subscriptionPlans.discountType` (string)
    Enum: "PERCENTAGE", "FIXED", "PRICE"

  - `subscriptionPlans.discountType2` (string)
    Enum: "PERCENTAGE", "FIXED", "PRICE"

  - `subscriptionPlans.discountEnabled` (boolean)

  - `subscriptionPlans.discountEnabled2` (boolean)

  - `subscriptionPlans.discountEnabledMasked` (boolean)

  - `subscriptionPlans.discountEnabled2Masked` (boolean)

  - `subscriptionPlans.frequencyType` (string)
    Enum: "ON_PURCHASE_DAY", "ON_SPECIFIC_DAY"

  - `subscriptionPlans.specificDayValue` (integer)

  - `subscriptionPlans.specificMonthValue` (integer)

  - `subscriptionPlans.specificDayEnabled` (boolean)

  - `subscriptionPlans.maxCycles` (integer)

  - `subscriptionPlans.minCycles` (integer)

  - `subscriptionPlans.cutOff` (integer)

  - `subscriptionPlans.prepaidFlag` (string)

  - `subscriptionPlans.idNew` (string)

  - `subscriptionPlans.planType` (string)
    Enum: "PAY_AS_YOU_GO", "PREPAID", "ADVANCED_PREPAID", "PAY_AS_YOU_GO_PREPAID"

  - `subscriptionPlans.deliveryPolicyPreAnchorBehavior` (string)
    Enum: "ASAP", "NEXT", "$UNKNOWN"

  - `subscriptionPlans.freeTrialEnabled` (boolean)

  - `subscriptionPlans.freeTrialCount` (integer)

  - `subscriptionPlans.freeTrialInterval` (string)
    Enum: "DAY", "WEEK", "MONTH", "YEAR"

  - `subscriptionPlans.memberOnly` (boolean)

  - `subscriptionPlans.nonMemberOnly` (boolean)

  - `subscriptionPlans.memberInclusiveTags` (string)

  - `subscriptionPlans.memberExclusiveTags` (string)

  - `subscriptionPlans.formFieldJson` (string)

  - `subscriptionPlans.upcomingOrderEmailBuffer` (integer)

  - `subscriptionPlans.frequencySequence` (integer)

  - `subscriptionPlans.groupName` (string)

  - `subscriptionPlans.groupId` (integer)

  - `subscriptionPlans.repeatingCycle` (boolean)

  - `subscriptionPlans.repeatingNumberOfCycle` (integer)

  - `subscriptionPlans.keepOriginalNextBillingDateAfterTrial` (boolean)

  - `subscriptionPlans.defaultSelectedPlan` (boolean)

  - `subscriptionPlans.inventoryPolicyReserve` (string)
    Enum: "ON_FULFILLMENT", "ON_SALE", "$UNKNOWN"

  - `subscriptionPlans.appstleCycles` (array)

  - `subscriptionPlans.appstleCycles.afterCycle` (integer)
    The billing cycle number after which this pricing applies
    Example: 3

  - `subscriptionPlans.appstleCycles.discountType` (string)
    Type of discount to apply in pricing cycles
    Enum: "PERCENTAGE", "FIXED", "PRICE", "SHIPPING", "FREE_PRODUCT", "PERCENTAGE", "FIXED", "PRICE", "SHIPPING", "FREE_PRODUCT"

  - `subscriptionPlans.appstleCycles.value` (number)
    Discount value. For PERCENTAGE: 0-100 (e.g., 10 for 10% off). For FIXED: amount to subtract from price. For PRICE: new fixed price. For SHIPPING: shipping discount amount. For FREE_PRODUCT: not used (set freeVariantId or freeProductHandle instead)
    Example: 10

  - `subscriptionPlans.appstleCycles.freeVariantId` (integer)
    Variant ID of a free product to add when discountType is FREE_PRODUCT
    Example: 42549172011164

  - `subscriptionPlans.appstleCycles.freeProductHandle` (string)
    Product handle of a free product to add when discountType is FREE_PRODUCT
    Example: "free-gift-product"

  - `subscriptionPlans.appstleCycles.repeatingCycle` (boolean)
    Whether this pricing should repeat for subsequent cycles
    Example: true

  - `subscriptionPlans.appstleCycles.repeatingNumberOfCycle` (integer)
    Number of cycles to repeat this pricing for when repeatingCycle is true
    Example: 6

  - `subscriptionPlans.appstleCycles.preventDuplicationFreeProduct` (boolean)
    Prevent adding duplicate free products if already in cart
    Example: true

  - `productIds` (string)

  - `productId` (string)

  - `variantIds` (string)

  - `accessoryProductIds` (string)

  - `updateProducts` (object)

  - `updateProducts.allProduct` (boolean)

  - `updateProducts.collectionId` (string)

  - `updateProducts.deleteAllProduct` (boolean)

  - `updateProducts.productDetails` (string)

  - `updateProducts.variantDetails` (string)

  - `deleteProducts` (object)

  - `translations` (string)


## Response 404 fields