---
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`

## Request

- Base URL: `https://api.voucherify.io`
- URL: `https://api.voucherify.io/v1/promotions/{campaignId}/stacks`
- Auth: one of:
  - API key in header `X-App-Id` and API key in header `X-App-Token`
  - OAuth 2
    - Implicit: `https://api.voucherify.io/v1/oauth/token`
    - Scopes: `api`, `promotions`

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.dev/voucherifyio/apis/voucherify-api-async-actions.md) - [All operations](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/llms.txt) - [OpenAPI document](https://skmtc.dev/voucherifyio/apis/voucherify-api-async-actions/revisions/4982266e0494?raw)