---
title: "List Selling Plan Groups"
method: GET
path: "/selling_plan_groups"
tags: ["Selling Plan Groups"]
---

# List Selling Plan Groups

`GET /selling_plan_groups`

## Request

- Base URL: `https://open.shopline.io/v1`
- URL: `https://open.shopline.io/v1/selling_plan_groups`
- Auth: HTTP bearer

Query selling plan groups by app_id.

## Query parameters

- `app_id` string, required
- `per_page` integer
- `page` integer
- `previous_id` string

## Response `200`

OK

- union
  - SellingPlanGroups
    - `items` SellingPlanGroup[]
      - `group_id` string: The ID of the selling plan group.
      - `name` string: Name of the selling plan group. Max 100 characters.
      - `description` string: Description of the selling plan group.
      - `selling_plans` SellingPlan[]
        - `selling_plan_id` string: The ID of the selling plan.
        - `name` string: The name describes the selling plan content. Max 100 characters.
        - `description` string: Buyer facing string which describes the selling plan commitment. Max 500 characters.
        - `category` 'preorder' | 'crowdfunding' | 'other': The category used to classify this selling plan for reporting purposes.
        - `delivery_policy` SellingPlanDeliveryPolicy
          - `delivery_policy_id` string: The ID of the delivery policy.
          - `delivery_trigger` 'EXACT_TIME': A selling plan policy which describes the delivery details.
          - `earliest_delivery_time` string: The earliest delivery time of the selling plan.
          - `latest_delivery_time` string: The latest delivery time of the selling plan.
      - `resources` SellingPlanGroupResource[]
        - `product_id` string: The ID of the product to associate with the selling plan group.
        - `sku_ids` string[]: The IDs of the variants to associate with the selling plan group.
    - `pagination` Paginatable
      - `current_page` integer: The current page number<br>當前分頁
      - `per_page` integer: Number of result per page<br>每頁顯示 n 筆資料<br>(Default: 24)
      - `total_count` integer: Number of result in total<br>資料總量
      - `total_pages` integer: Number of pages in total<br>總頁數量
    - `last_id` string
  - SellingPlanGroupsCursorBased
    - `items` SellingPlanGroup[]
      - `group_id` string: The ID of the selling plan group.
      - `name` string: Name of the selling plan group. Max 100 characters.
      - `description` string: Description of the selling plan group.
      - `selling_plans` SellingPlan[]
        - `selling_plan_id` string: The ID of the selling plan.
        - `name` string: The name describes the selling plan content. Max 100 characters.
        - `description` string: Buyer facing string which describes the selling plan commitment. Max 500 characters.
        - `category` 'preorder' | 'crowdfunding' | 'other': The category used to classify this selling plan for reporting purposes.
        - `delivery_policy` SellingPlanDeliveryPolicy
          - `delivery_policy_id` string: The ID of the delivery policy.
          - `delivery_trigger` 'EXACT_TIME': A selling plan policy which describes the delivery details.
          - `earliest_delivery_time` string: The earliest delivery time of the selling plan.
          - `latest_delivery_time` string: The latest delivery time of the selling plan.
      - `resources` SellingPlanGroupResource[]
        - `product_id` string: The ID of the product to associate with the selling plan group.
        - `sku_ids` string[]: The IDs of the variants to associate with the selling plan group.
    - `last_id` LastId (unresolved $ref)
    - `limit` Limit (unresolved $ref)

## Changes

- **2026-11-03** `d2518391b149`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/shoplineapp/apis/shopline-open-api/changes/selling_plan_groups/get.md)

---

[API](https://skmtc.dev/shoplineapp/apis/shopline-open-api.md) - [All operations](https://skmtc.dev/shoplineapp/apis/shopline-open-api/llms.txt) - [OpenAPI document](https://skmtc.dev/shoplineapp/apis/shopline-open-api/revisions/d2518391b149?raw)