> ## 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 all selling plans across all subscription groups

> Retrieves a flattened list of all selling plans from all subscription groups in the store. This endpoint provides a consolidated view of every subscription plan available, regardless of which group it belongs to.

**Response includes:**
- All selling plans with their configurations
- Group information for each plan (groupId and groupName)
- Complete discount and pricing details
- Delivery and billing frequencies
- Member restrictions and settings
- Free trial configurations

**Use Cases:**
- Build a unified subscription selector
- Compare all available subscription options
- Analyze pricing across all plans
- Find specific plan configurations
- Generate reports on subscription offerings

**Differences from /subscription-groups endpoint:**
- Returns plans as a flat list, not grouped
- Each plan includes its parent group information
- Easier to search/filter across all plans
- Does not include product/variant assignments

**Authentication:** Requires valid X-API-Key header



## OpenAPI

````yaml /subscription/admin-api-swagger.json get /api/external/v2/subscription-groups/all-selling-plans
openapi: 3.0.1
info:
  description: >-
    Comprehensive API documentation for managing subscriptions, payments, and
    related operations. These APIs allow you to programmatically manage
    subscription lifecycles, handle payments, configure products, and integrate
    subscription functionality into your applications.
  title: Admin APIs
  version: 0.0.1
servers:
  - url: https://subscription-admin.appstle.com
security: []
tags:
  - description: >-
      Core APIs for managing the complete subscription lifecycle including
      creation, updates, pausing, resuming, and cancellation of subscriptions.
    name: Subscription Management
  - description: >-
      APIs for managing subscription payment methods, processing payments,
      handling payment retries, and updating billing information.
    name: Subscription Payments
  - description: >-
      APIs for managing subscription contracts including delivery schedules,
      pricing, order notes, billing cycles, and shipping addresses.
    name: Subscription Contracts
  - description: >-
      APIs for managing products within subscriptions including adding,
      removing, updating quantities, and swapping products.
    name: Subscription Products
  - description: >-
      APIs for handling billing operations, payment processing, and financial
      transactions related to subscriptions.
    name: Billing & Payments
  - description: >-
      APIs for managing discounts and promotional codes applied to
      subscriptions.
    name: Subscription Discounts
  - 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 managing subscription plans, pricing tiers, and plan
      configurations.
    name: Subscription Plans
  - description: >-
      APIs for managing customizable product boxes and bundles where customers
      can select multiple items.
    name: Build-a-Box & Bundles
  - description: >-
      APIs for managing the product catalog including product information,
      variants, and inventory.
    name: Product Catalog
  - description: >-
      APIs for managing operational settings, configurations, and administrative
      functions.
    name: Operations & Settings
  - description: >-
      APIs powering the customer-facing portal where subscribers can manage
      their own subscriptions.
    name: Customer Portal
  - description: APIs for managing customer information, profiles, and account details.
    name: Customers
  - description: >-
      APIs for retrieving aggregated subscription data, customer subscription
      history, and account-level subscription information.
    name: Subscription Data
  - description: >-
      APIs for managing delivery profiles, shipping rates, free shipping
      configuration, and delivery method options on subscriptions.
    name: Delivery & Shipping
  - description: >-
      APIs for managing storefront customization including custom CSS, theme
      settings, label translations, and merchant-defined widget configuration.
    name: Customization
  - description: >-
      APIs for configuring cancellation flows, retention offers, cancellation
      reason management, and win-back automation.
    name: Customer Retention
paths:
  /api/external/v2/subscription-groups/all-selling-plans:
    get:
      tags:
        - Subscription Plans
      summary: Get all selling plans across all subscription groups
      description: >-
        Retrieves a flattened list of all selling plans from all subscription
        groups in the store. This endpoint provides a consolidated view of every
        subscription plan available, regardless of which group it belongs to.


        **Response includes:**

        - All selling plans with their configurations

        - Group information for each plan (groupId and groupName)

        - Complete discount and pricing details

        - Delivery and billing frequencies

        - Member restrictions and settings

        - Free trial configurations


        **Use Cases:**

        - Build a unified subscription selector

        - Compare all available subscription options

        - Analyze pricing across all plans

        - Find specific plan configurations

        - Generate reports on subscription offerings


        **Differences from /subscription-groups endpoint:**

        - Returns plans as a flat list, not grouped

        - Each plan includes its parent group information

        - Easier to search/filter across all plans

        - Does not include product/variant assignments


        **Authentication:** Requires valid X-API-Key header
      operationId: getAllSellingPlansV2External
      parameters:
        - deprecated: true
          description: API Key (Deprecated - Use X-API-Key header instead)
          in: query
          name: api_key
          required: false
          schema:
            type: string
        - description: API Key for authentication
          example: sk_live_1234567890abcdef
          in: header
          name: X-API-Key
          required: true
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Success Response:
                  description: Success Response
                  value:
                    - afterCycle1: 0
                      billingFrequencyCount: 1
                      billingFrequencyInterval: MONTH
                      discountEnabled: true
                      discountOffer: 10
                      discountType: PERCENTAGE
                      frequencyCount: 1
                      frequencyDescription: Save 10% on monthly deliveries
                      frequencyInterval: MONTH
                      frequencyName: Delivered Monthly
                      frequencyType: ON_PURCHASE_DAY
                      groupId: 123456789
                      groupName: Monthly Coffee Subscription
                      id: gid://shopify/SellingPlan/111111
                      inventoryPolicyReserve: ON_SALE
                      maxCycles: null
                      memberOnly: false
                      minCycles: 3
                      planType: PAY_AS_YOU_GO
                      upcomingOrderEmailBuffer: 3
                    - afterCycle1: 0
                      billingFrequencyCount: 1
                      billingFrequencyInterval: WEEK
                      discountEnabled: true
                      discountOffer: 15
                      discountType: PERCENTAGE
                      frequencyCount: 1
                      frequencyDescription: Fresh tea every week with 15% savings
                      frequencyInterval: WEEK
                      frequencyName: Weekly Tea Box
                      groupId: 123456790
                      groupName: Premium Tea Collection
                      id: gid://shopify/SellingPlan/222222
                      planType: PAY_AS_YOU_GO
                    - afterCycle1: 0
                      billingFrequencyCount: 3
                      billingFrequencyInterval: MONTH
                      discountEnabled: true
                      discountOffer: 25
                      discountType: PERCENTAGE
                      frequencyCount: 1
                      frequencyDescription: Pay upfront for 3 months and save 25%
                      frequencyInterval: MONTH
                      frequencyName: 3-Month Prepaid Coffee
                      groupId: 123456789
                      groupName: Monthly Coffee Subscription
                      id: gid://shopify/SellingPlan/333333
                      maxCycles: 12
                      payAsYouGoPrepaidBillingFrequencyCount: 3
                      planType: PAY_AS_YOU_GO_PREPAID
                      repeatingCycle: true
                      repeatingNumberOfCycle: 12
              schema:
                $ref: '#/components/schemas/FrequencyInfoDTO'
          description: Successfully retrieved all selling plans
        '401':
          content:
            '*/*':
              schema:
                items:
                  $ref: '#/components/schemas/FrequencyInfoDTO'
                type: array
          description: Authentication required - missing or invalid API key
        '403':
          content:
            '*/*':
              schema:
                items:
                  $ref: '#/components/schemas/FrequencyInfoDTO'
                type: array
          description: Insufficient permissions to view selling plans
        '500':
          content:
            '*/*':
              schema:
                items:
                  $ref: '#/components/schemas/FrequencyInfoDTO'
                type: array
          description: Internal server error
components:
  schemas:
    FrequencyInfoDTO:
      properties:
        afterCycle1:
          format: int32
          type: integer
        afterCycle2:
          format: int32
          type: integer
        appstleCycles:
          items:
            $ref: '#/components/schemas/AppstleCycle'
          type: array
        billingFrequencyCount:
          format: int32
          type: integer
        billingFrequencyInterval:
          enum:
            - DAY
            - WEEK
            - MONTH
            - YEAR
          type: string
        cutOff:
          format: int32
          type: integer
        defaultSelectedPlan:
          type: boolean
        deliveryPolicyPreAnchorBehavior:
          enum:
            - ASAP
            - NEXT
            - $UNKNOWN
          type: string
        discountEnabled:
          type: boolean
        discountEnabled2:
          type: boolean
        discountEnabled2Masked:
          type: boolean
        discountEnabledMasked:
          type: boolean
        discountOffer:
          format: double
          type: number
        discountOffer2:
          format: double
          type: number
        discountType:
          enum:
            - PERCENTAGE
            - FIXED
            - PRICE
          type: string
        discountType2:
          enum:
            - PERCENTAGE
            - FIXED
            - PRICE
          type: string
        fixedBillingDates:
          items:
            $ref: '#/components/schemas/FixedBillingDate'
          type: array
        formFieldJson:
          type: string
        freeTrialCount:
          format: int32
          type: integer
        freeTrialEnabled:
          type: boolean
        freeTrialInterval:
          enum:
            - DAY
            - WEEK
            - MONTH
            - YEAR
          type: string
        frequencyCount:
          format: int32
          type: integer
        frequencyDescription:
          type: string
        frequencyInterval:
          enum:
            - DAY
            - WEEK
            - MONTH
            - YEAR
          type: string
        frequencyName:
          type: string
        frequencyNameTranslations:
          additionalProperties:
            additionalProperties:
              type: string
            type: object
          type: object
        frequencySequence:
          format: int32
          type: integer
        frequencyType:
          enum:
            - ON_PURCHASE_DAY
            - ON_SPECIFIC_DAY
            - ON_FIXED_DATES
          type: string
        groupId:
          format: int64
          type: integer
        groupName:
          type: string
        id:
          type: string
        idNew:
          type: string
        inventoryPolicyReserve:
          enum:
            - ON_FULFILLMENT
            - ON_SALE
            - $UNKNOWN
          type: string
        keepOriginalNextBillingDateAfterTrial:
          type: boolean
        maxCycles:
          format: int32
          type: integer
        memberExclusiveTags:
          type: string
        memberInclusiveTags:
          type: string
        memberOnly:
          type: boolean
        minCycles:
          format: int32
          type: integer
        nonMemberOnly:
          type: boolean
        payAsYouGoPrepaidBillingFrequencyCount:
          format: int32
          type: integer
        planType:
          enum:
            - PAY_AS_YOU_GO
            - PREPAID
            - ADVANCED_PREPAID
            - PAY_AS_YOU_GO_PREPAID
          type: string
        prepaidFlag:
          type: string
        repeatingCycle:
          type: boolean
        repeatingNumberOfCycle:
          format: int32
          type: integer
        specificDayEnabled:
          type: boolean
        specificDayValue:
          format: int32
          type: integer
        specificMonthValue:
          format: int32
          type: integer
        upcomingOrderEmailBuffer:
          format: int32
          type: integer
      type: object
    AppstleCycle:
      description: Custom pricing cycle configuration for subscription line items
      properties:
        afterCycle:
          description: The billing cycle number after which this pricing applies
          example: 3
          format: int32
          minimum: 1
          type: integer
        discountType:
          description: Type of discount to apply in pricing cycles
          enum:
            - PERCENTAGE
            - FIXED
            - PRICE
            - SHIPPING
            - FREE_PRODUCT
            - PERCENTAGE
            - FIXED
            - PRICE
            - SHIPPING
            - FREE_PRODUCT
          example: PERCENTAGE
          type: string
        freeProductHandle:
          description: >-
            Product handle of a free product to add when discountType is
            FREE_PRODUCT
          example: free-gift-product
          type: string
        freeProductTitle:
          description: Display title of the free product when discountType is FREE_PRODUCT
          example: Ceramic Mug
          type: string
        freeVariantId:
          description: >-
            Variant ID of a free product to add when discountType is
            FREE_PRODUCT
          example: 42549172011164
          format: int64
          type: integer
        preventDuplicationFreeProduct:
          description: Prevent adding duplicate free products if already in cart
          example: true
          type: boolean
        repeatingCycle:
          description: Whether this pricing should repeat for subsequent cycles
          example: true
          type: boolean
        repeatingNumberOfCycle:
          description: >-
            Number of cycles to repeat this pricing for when repeatingCycle is
            true
          example: 6
          format: int32
          minimum: 1
          type: integer
        value:
          description: >-
            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
          format: double
          type: number
      type: object
    FixedBillingDate:
      properties:
        day:
          format: int32
          type: integer
        month:
          format: int32
          type: integer
      type: object

````