# Get bundle details by handle

Retrieves complete details for a subscription bundle using its unique handle. This endpoint returns the bundle configuration, included products, pricing, and available subscription options.

Bundle Information Returned:
- Bundle name and description
- Product selections with quantities
- Pricing and discounts
- Available subscription frequencies
- Bundle status and availability
- Product images and details

Use Cases:
- Display bundle details on product pages
- Show bundle contents in customer portal
- Fetch bundle configuration for cart/checkout
- Integration with external systems
- Build custom bundle selection interfaces

Bundle Handle:
The handle is a unique, URL-friendly identifier for the bundle. It's typically generated when the bundle is created and remains constant throughout the bundle's lifecycle.

Authentication: Requires valid X-API-Key header

Endpoint: GET /api/external/v2/subscription-bundlings/external/get-bundle/{handle}
Version: 0.0.1

## Path parameters:

  - `handle` (string, required)
    Customer Handle

## Query parameters:

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

## Header parameters:

  - `X-API-Key` (string)

## Response 401 fields (*/*):

  - `bundle` (object)

  - `bundle.id` (integer)

  - `bundle.shop` (string, required)

  - `bundle.subscriptionBundlingEnabled` (boolean)

  - `bundle.subscriptionId` (integer)

  - `bundle.minProductCount` (integer)

  - `bundle.maxProductCount` (integer)

  - `bundle.discount` (number)

  - `bundle.uniqueRef` (string)

  - `bundle.bundleRedirect` (string)
    Enum: "CART", "CHECKOUT", "CUSTOM", "NONE"

  - `bundle.customRedirectURL` (string)

  - `bundle.minOrderAmount` (number)

  - `bundle.tieredDiscount` (string)

  - `bundle.productViewStyle` (string)
    Enum: "QUICK_ADD", "VIEW_DETAILS"

  - `bundle.buildABoxType` (string)
    Enum: "CLASSIC", "SINGLE_PRODUCT", "MIX_AND_MATCH", "INFINITE", "CUSTOMIZE_BUNDLE", "CLASSIC_BUILD_A_BOX", "SINGLE_PRODUCT_BUILD_A_BOX", "VOLUME_DISCOUNT", "DISCOUNTED_PRICING", "SHIPPING_DISCOUNT", "BUY_X_GET_Y", "SECTIONED_BUNDLE"

  - `bundle.singleProductSettings` (string)

  - `bundle.subscriptionGroup` (string)

  - `bundle.bundleTopHtml` (string)

  - `bundle.bundleBottomHtml` (string)

  - `bundle.proceedToCheckoutButtonText` (string)

  - `bundle.chooseProductsText` (string)

  - `bundle.name` (string)

  - `bundle.trackInventory` (boolean)

  - `bundle.allowOneTimePurchase` (boolean)

  - `bundle.thirdPartyRule` (boolean)

  - `bundle.selectionType` (string)
    Enum: "FIXED", "FLEXIBLE"

  - `bundle.variants` (string)

  - `bundle.discountedVariants` (string)

  - `bundle.sections` (string)

  - `bundle.appliesOn` (string)
    Enum: "PRODUCT", "COLLECTION", "BOTH", "ONE_TIME", "SUBSCRIPTION"

  - `bundle.productDiscountType` (string)
    Enum: "SELECTED_PRODUCT", "EACH_PRODUCT"

  - `bundle.collectionData` (string)

  - `bundle.productSelectionType` (string)
    Enum: "PRODUCT", "COLLECTION"

  - `bundle.sellingPlanIds` (string)

  - `bundle.minUniqueProductCheck` (boolean)

  - `subscriptions` (array)

  - `subscriptions.groupName` (string)

  - `subscriptions.productCount` (integer)

  - `subscriptions.productVariantCount` (integer)

  - `subscriptions.infoJson` (string)

  - `subscriptions.productIds` (string)

  - `subscriptions.variantIds` (string)

  - `subscriptions.variantProductIds` (string)

  - `subscriptions.translations` (string)

  - `products` (array)

  - `products.productId` (integer)

  - `products.productTitle` (string)

  - `products.productHandle` (string)

## Response 403 fields (*/*):

  - `bundle` (object)

  - `bundle.id` (integer)

  - `bundle.shop` (string, required)

  - `bundle.subscriptionBundlingEnabled` (boolean)

  - `bundle.subscriptionId` (integer)

  - `bundle.minProductCount` (integer)

  - `bundle.maxProductCount` (integer)

  - `bundle.discount` (number)

  - `bundle.uniqueRef` (string)

  - `bundle.bundleRedirect` (string)
    Enum: "CART", "CHECKOUT", "CUSTOM", "NONE"

  - `bundle.customRedirectURL` (string)

  - `bundle.minOrderAmount` (number)

  - `bundle.tieredDiscount` (string)

  - `bundle.productViewStyle` (string)
    Enum: "QUICK_ADD", "VIEW_DETAILS"

  - `bundle.buildABoxType` (string)
    Enum: "CLASSIC", "SINGLE_PRODUCT", "MIX_AND_MATCH", "INFINITE", "CUSTOMIZE_BUNDLE", "CLASSIC_BUILD_A_BOX", "SINGLE_PRODUCT_BUILD_A_BOX", "VOLUME_DISCOUNT", "DISCOUNTED_PRICING", "SHIPPING_DISCOUNT", "BUY_X_GET_Y", "SECTIONED_BUNDLE"

  - `bundle.singleProductSettings` (string)

  - `bundle.subscriptionGroup` (string)

  - `bundle.bundleTopHtml` (string)

  - `bundle.bundleBottomHtml` (string)

  - `bundle.proceedToCheckoutButtonText` (string)

  - `bundle.chooseProductsText` (string)

  - `bundle.name` (string)

  - `bundle.trackInventory` (boolean)

  - `bundle.allowOneTimePurchase` (boolean)

  - `bundle.thirdPartyRule` (boolean)

  - `bundle.selectionType` (string)
    Enum: "FIXED", "FLEXIBLE"

  - `bundle.variants` (string)

  - `bundle.discountedVariants` (string)

  - `bundle.sections` (string)

  - `bundle.appliesOn` (string)
    Enum: "PRODUCT", "COLLECTION", "BOTH", "ONE_TIME", "SUBSCRIPTION"

  - `bundle.productDiscountType` (string)
    Enum: "SELECTED_PRODUCT", "EACH_PRODUCT"

  - `bundle.collectionData` (string)

  - `bundle.productSelectionType` (string)
    Enum: "PRODUCT", "COLLECTION"

  - `bundle.sellingPlanIds` (string)

  - `bundle.minUniqueProductCheck` (boolean)

  - `subscriptions` (array)

  - `subscriptions.groupName` (string)

  - `subscriptions.productCount` (integer)

  - `subscriptions.productVariantCount` (integer)

  - `subscriptions.infoJson` (string)

  - `subscriptions.productIds` (string)

  - `subscriptions.variantIds` (string)

  - `subscriptions.variantProductIds` (string)

  - `subscriptions.translations` (string)

  - `products` (array)

  - `products.productId` (integer)

  - `products.productTitle` (string)

  - `products.productHandle` (string)


## Response 200 fields

## Response 404 fields