---
title: "Get promotion product list"
method: GET
path: "/shops/{SHOP_ID}/promotion_advance"
tags: ["Promotion"]
---

# Get promotion product list

`GET /shops/{SHOP_ID}/promotion_advance`

Get list of promotions

## Path parameters

- `SHOP_ID` integer, required

## Query parameters

- `page` integer
- `page_size` integer
- `textSearch` string

## Response `200`

Success

- object
  - `data` Promotion[] — List of promotions
    - `id` string — Promotion ID
    - `display_id` string — Promotion display ID
    - `name` string — Promotion name
    - `type` string — Promotion type
    - `start_time` string, date-time — Start time
    - `end_time` string, date-time — End time
    - `warehouse_ids` string[] — Warehouse IDs
    - `customer_tags` string[] — Customer tags
    - `order_sources` object[] — Order sources
    - `group_name` string — Promotion group
    - `is_activated` boolean — Is activated
    - `is_variation` boolean — Is variation
    - `is_used` boolean — Is used
    - `is_free_shipping` boolean — Is free shipping
    - `is_discount_in_birthday_customer` boolean — Is discount in birthday customer
    - `coupon_info` object — Coupon information
      - `discount` integer — Discount
      - `is_percent` boolean — Is percent
    - `promo_code_info` object — Promotion code information
      - `discount` integer — Discount
      - `is_percent` boolean — Is percent
      - `max_discount_by_percent` integer — Maximum discount by percent
    - `discount_by_quantity` integer — Discount by quantity
    - `items` object[] — List of promotion items (products/variations the promotion applies to)
      - `id` string — Promotion item ID
      - `promotion_advance_id` string — Promotion ID
      - `shop_id` integer — Shop ID
      - `product_id` string, nullable — Product ID (when promotion is applied by product)
      - `variation_id` string, nullable — Variation ID (when promotion is applied by variation)
      - `category_id` string, nullable — Category ID (when promotion is applied by category)
      - `product` object, nullable — Product information (when promotion is applied by product)
      - `variation` object, nullable — Variation information (when promotion is applied by variation)
      - `level_info` object[] — Discount levels by quantity
        - `discount` number — Discount value
        - `is_percent` boolean — Is percent
        - `from_quantity` integer — From quantity
        - `to_quantity` integer — To quantity
      - `fixed_prices` number — Fixed price
      - `coupon_item_info` object — Coupon information of the item
        - `discount` number — Discount
        - `is_percent` boolean — Is percent
      - `limited_quantity` integer — Limited quantity
      - `limited_quantity_used` integer — Limited quantity used
      - `attachment_product_info` object[] — Attached product information
        - `product_id` string, nullable — Attached product ID
        - `variation_id` string, nullable — Attached variation ID
        - `quantity` integer — Attached product quantity
      - `discount_info_by_attachment_product` object, nullable — Discount by attached product
        - `discount` number — Discount value
        - `is_percent` boolean — Is percent
        - `quantity` integer — Quantity to apply discount
      - `inserted_at` string, date-time — Inserted at
      - `updated_at` string, date-time — Updated at
    - `bonus_items` object[] — Bonus items
    - `total_quantity_bonus` integer — Total quantity bonus
    - `arr_level_promotion` object[] — Level promotion array
    - `level_order_prices` object[] — Level order prices
    - `priority_level` integer — Priority level
    - `type_employee` string — Type employee
    - `post_ids` string[] — Post IDs
    - `shop_id` integer — Shop ID
    - `creator_id` string — Creator ID
    - `inserted_at` string, date-time — Inserted at
    - `updated_at` string, date-time — Updated at
  - `page_number` integer — Page number
  - `page_size` integer — Page size
  - `success` boolean — Success status
  - `total_entries` integer — Total entries
  - `total_pages` integer — Total pages

---

[API](https://skmtc.dev/pancake/apis/pancake-pos-open-api.md) · [All operations](https://skmtc.dev/pancake/apis/pancake-pos-open-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pancake/apis/pancake-pos-open-api/revisions/fc5c760fb2b3?raw)