# Get bundle details by handle

Retrieves detailed information about a subscription product bundle including bundled items, pricing, and subscription plan details.

Key Information Returned:
- Bundle Configuration: Name, handle, description, status
- Bundled Items: Products included in the bundle with quantities
- Pricing: Total price, individual item prices, discounts
- Subscription Details: Associated membership plan, billing frequency
- Product Information: Variant details, images, availability
- Display Settings: How the bundle should be presented to customers

Bundle Components:
- Product handles and variant IDs
- Quantity per product in the bundle
- Bundle-level discounts or pricing rules
- Subscription plan associations
- Custom attributes and metadata

Use Cases:
- Display bundle details on product pages
- Retrieve bundle configuration for cart integration
- Show customers what's included in a bundle
- Sync bundle data with external systems
- Build custom bundle selection interfaces

Authentication: Requires API key authentication via X-API-Key header or api_key parameter

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

## Path parameters:

  - `handle` (string, required)
    Unique bundle identifier (handle/slug)
    Example: "coffee-bundle-monthly"

## Query parameters:

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

## Header parameters:

  - `X-API-Key` (string)

## Response 200 fields (application/json):

  - `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)

  - `subscription` (object)

  - `subscription.groupName` (string)

  - `subscription.productCount` (integer)

  - `subscription.productVariantCount` (integer)

  - `subscription.infoJson` (string)

  - `subscription.productIds` (string)

  - `subscription.variantIds` (string)

  - `subscription.variantProductIds` (string)

  - `subscription.customerTag` (string)

  - `subscription.orderTag` (string)

  - `subscription.rulesJson` (string)

  - `subscription.formFieldsJson` (string)

  - `subscription.savedSearchId` (string)

  - `subscription.savedSegmentSearchId` (string)

  - `subscription.planSequence` (integer)

  - `subscription.memberOrderTag` (string)

  - `products` (array)

  - `products.productId` (integer)

  - `products.productTitle` (string)

  - `products.productHandle` (string)

  - `variants` (array)

## 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)

  - `subscription` (object)

  - `subscription.groupName` (string)

  - `subscription.productCount` (integer)

  - `subscription.productVariantCount` (integer)

  - `subscription.infoJson` (string)

  - `subscription.productIds` (string)

  - `subscription.variantIds` (string)

  - `subscription.variantProductIds` (string)

  - `subscription.customerTag` (string)

  - `subscription.orderTag` (string)

  - `subscription.rulesJson` (string)

  - `subscription.formFieldsJson` (string)

  - `subscription.savedSearchId` (string)

  - `subscription.savedSegmentSearchId` (string)

  - `subscription.planSequence` (integer)

  - `subscription.memberOrderTag` (string)

  - `products` (array)

  - `products.productId` (integer)

  - `products.productTitle` (string)

  - `products.productHandle` (string)

  - `variants` (array)

## Response 404 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)

  - `subscription` (object)

  - `subscription.groupName` (string)

  - `subscription.productCount` (integer)

  - `subscription.productVariantCount` (integer)

  - `subscription.infoJson` (string)

  - `subscription.productIds` (string)

  - `subscription.variantIds` (string)

  - `subscription.variantProductIds` (string)

  - `subscription.customerTag` (string)

  - `subscription.orderTag` (string)

  - `subscription.rulesJson` (string)

  - `subscription.formFieldsJson` (string)

  - `subscription.savedSearchId` (string)

  - `subscription.savedSegmentSearchId` (string)

  - `subscription.planSequence` (integer)

  - `subscription.memberOrderTag` (string)

  - `products` (array)

  - `products.productId` (integer)

  - `products.productTitle` (string)

  - `products.productHandle` (string)

  - `variants` (array)