---
title: "List Promotion Stacks in Campaign"
method: GET
path: "/v1/promotions/{campaignId}/stacks"
tags: ["Promotions"]
---

# List Promotion Stacks in Campaign

`GET /v1/promotions/{campaignId}/stacks`

This method enables you to list promotion stacks from a specified campaign.

## Response `200`

Returns a list of promotion stack objects.

- PromotionsStacksListResponseBody — Response body schema for **GET** `v1/promotions/stacks` and for **GET** `v1/promotions/{campaignId}/stacks`.
  - `object` 'list', required — The type of the object represented by JSON. This object stores information about promotion stacks in a dictionary.
  - `data_ref` 'data', required — Identifies the name of the attribute that contains the array of promotion stack objects.
  - `data` PromotionStack[], required — Contains array of promotion stack objects.
    - `name` string, required — Promotion stack name.
    - `tiers` object, required — Contains the tier configuration. A promotion stack can include up to 30 tiers.
      - `ids` string[], required — Contains the list of tiers in a pre-defined sequence.
      - `hierarchy_mode` 'MANUAL'
    - `id` string, required — Unique promotion stack ID.
    - `created_at` string, date-time, required — Timestamp representing the date and time when the promotion stack was created. The value is shown in the ISO 8601 format.
    - `updated_at` string, date-time — Timestamp representing the date and time when the promotion stack was updated. The value is shown in the ISO 8601 format.
    - `campaign_id` string, required — Promotion stack's parent campaign's unique ID.
    - `object` 'promotion_stack', required — The type of the object represented by JSON.
    - `category_id` string, nullable, required — Promotion stack category ID.
    - `categories` Category[], required — Details about the category assigned to the promotion stack.
      - `id` string, required — Unique category ID assigned by Voucherify.
      - `name` string, required — Category name.
      - `hierarchy` integer, required — Category hierarchy. Categories with lower hierarchy are processed before categories with higher hierarchy value.
      - `object` 'category', required — The type of the object represented by the JSON. This object stores information about the category.
      - `created_at` string, date-time, required — Timestamp representing the date and time when the category was created. The value is shown in the ISO 8601 format.
      - `updated_at` string, date-time — Timestamp representing the date and time when the category was updated. The value is shown in the ISO 8601 format.
  - `total` integer, required — Total number of promotion stacks.

---

[API](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions.md) · [All operations](https://skmtc.net/voucherifyio/apis/voucherify-api-async-actions/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voucherifyio/voucherify-api-async-actions/revisions/4982266e0494/schema)