---
title: "Get Promotion Stack"
method: GET
path: "/v1/promotions/{campaignId}/stacks/{stackId}"
tags: ["Promotions"]
---

# Get Promotion Stack

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

This method returns the details of a promotion stack, including the promotion tiers grouped within the stack.

## Response `200`

Returns a stack object if valid identifiers were provided in the path.

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

## Other responses

- `404` — Returns an error if the campaign or promotion stack cannot be found.

---

[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/versions/4982266e0494/schema)