> ## Documentation Index > Fetch the complete documentation index at: https://developers.appstle.com/llms.txt > Use this file to discover all available pages before exploring further. # Get public Build-a-Box bundle details by handle (v3) ## OpenAPI ````yaml /subscription/storefront-api-swagger.json get /subscriptions/cp/api/v3/subscription-bundlings/external/get-bundle/{handle} openapi: 3.0.1 info: description: >- Comprehensive API documentation for the customer-facing subscription portal. These APIs enable customers to manage their subscriptions, update billing information, modify delivery schedules, and access their account details through your storefront. **Important**: These APIs must be called from your shop's domain (e.g., https://www.myshop.com/apps/subscriptions/cp/api/**) and require customer authentication. Unauthenticated requests will return a 401 Unauthorized error. title: Storefront APIs version: 0.0.1 servers: - url: https://www.myshop.com/apps security: [] tags: - description: >- Core customer portal APIs for managing customer account settings, authentication, and portal configurations. name: Customer Portal - description: >- APIs for customers to view and manage their subscription contracts including status updates, frequency changes, and cancellations. name: Subscription Management - description: >- APIs for retrieving and updating subscription contract details — delivery schedules, line items, addresses, billing cycles. name: Subscription Contracts - description: >- APIs for retrieving available subscription plans and selling plan configurations exposed to customers. name: Subscription Plans - description: >- APIs for managing one-time add-on products that can be purchased alongside recurring subscription items. name: Subscription One-Time Products - description: >- APIs for retrieving aggregated subscription data and account-level subscription information for the signed-in customer. name: Subscription Data - description: >- APIs for managing customizable product boxes and bundles where customers can select multiple items. name: Build-a-Box & Bundles - description: >- APIs for managing payment methods, billing information, and processing subscription payments. name: Billing & Payments - description: >- APIs for retrieving product information, selling plans, variant data, and subscription-enabled products available to customers. name: Product Catalog - description: >- APIs for managing delivery schedules, shipping addresses, delivery methods, and tracking order status. name: Delivery & Shipping - description: >- APIs for handling subscription cancellations, retention activities, and customer feedback management. name: Customer Retention - description: >- APIs for integrating loyalty programs with subscriptions including points redemption and earning options. name: Loyalty Integration - description: >- APIs for accessing portal customization settings, translations, and theme configurations. name: Customization - description: >- APIs for retrieving promotional campaigns shown in the customer portal, tracking banner engagement, and redeeming campaign offers. name: Campaigns - description: >- APIs for local pickup and click-and-collect — listing pickup locations and resolving eligible pickup dates and time slots. name: Store Pickup paths: /subscriptions/cp/api/v3/subscription-bundlings/external/get-bundle/{handle}: get: tags: - Build-a-Box & Bundles summary: Get public Build-a-Box bundle details by handle (v3) operationId: getValidSubscriptionCustomerV2 parameters: - description: Customer Handle in: path name: handle required: true schema: type: string responses: '200': content: '*/*': schema: $ref: '#/components/schemas/SubscriptionBundlingResponseV3' description: OK components: schemas: SubscriptionBundlingResponseV3: properties: bundle: $ref: '#/components/schemas/SubscriptionBundling' products: items: $ref: '#/components/schemas/ProductInfo' type: array subscription: $ref: '#/components/schemas/SubscriptionGroupPlan' subscriptionGroupPlans: items: $ref: '#/components/schemas/SubscriptionGroupPlan' type: array subscriptionPlanProductInfoMap: additionalProperties: items: $ref: '#/components/schemas/ProductInfo' type: array type: object subscriptionPlanVariantMap: additionalProperties: items: type: string type: array type: object variants: items: type: string type: array type: object SubscriptionBundling: properties: allowOneTimePurchase: type: boolean appliesOn: enum: - PRODUCT - COLLECTION - BOTH - ONE_TIME - SUBSCRIPTION type: string buildABoxType: 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 type: string bundleBottomHtml: type: string bundleRedirect: enum: - CART - CHECKOUT - CUSTOM - NONE type: string bundleTopHtml: type: string chooseProductsText: type: string collectionData: type: string customRedirectURL: type: string discount: format: double type: number discountedVariants: type: string id: format: int64 type: integer maxProductCount: format: int32 type: integer minOrderAmount: format: double type: number minProductCount: format: int32 type: integer minUniqueProductCheck: type: boolean name: type: string proceedToCheckoutButtonText: type: string productDiscountType: enum: - SELECTED_PRODUCT - EACH_PRODUCT type: string productSelectionType: enum: - PRODUCT - COLLECTION type: string productViewStyle: enum: - QUICK_ADD - VIEW_DETAILS type: string sections: type: string selectionType: enum: - FIXED - FLEXIBLE type: string sellingPlanIds: type: string shop: type: string singleProductSettings: type: string subscriptionBundlingEnabled: type: boolean subscriptionGroup: type: string subscriptionId: format: int64 type: integer thirdPartyRule: type: boolean tieredDiscount: type: string trackInventory: type: boolean uniqueRef: type: string variants: type: string required: - shop type: object ProductInfo: properties: id: format: int64 type: integer productHandle: type: string productId: format: int64 type: integer productTitle: type: string shop: type: string required: - shop type: object SubscriptionGroupPlan: properties: groupName: type: string id: format: int64 type: integer infoJson: type: string productCount: format: int32 type: integer productIds: type: string productVariantCount: format: int32 type: integer shop: type: string subscriptionId: format: int64 type: integer translations: type: string variantIds: type: string variantProductIds: type: string required: - shop type: object ````