---
title: "List Promotion Stacks"
method: GET
path: "/v1/promotions/stacks"
tags: ["Promotions"]
---

# List Promotion Stacks

`GET /v1/promotions/stacks`

This method enables you to list promotion stacks irrespective of the campaign they are associated with. 

You can use filters in the query parameters to specify the stacks to be returned in the response.

## Advanced filters for fetching promotion stacks

| **Filters** | **Examples** |
| :--- | :--- |
| Created Before | - `[created_at][before]=2021-12-30T13:52:18.227Z`<br />- `[filters][created_at][conditions][$before][0]=2021-12-30T13:52:18.227Z` |
| Created After | - `[created_at][after]=2021-12-30T13:52:18.227Z`<br />- `[filters][created_at][conditions][$after][0]=2021-12-30T13:52:18.227Z` |
| Updated Before | - `[updated_at][before]=2021-12-30T13:52:18.227Z`<br />- `[filters][updated_at][conditions][$before][0]=2021-12-30T13:52:18.227Z` |
| Updated After | - `[updated_at][after]=2021-12-30T13:52:18.227Z`<br />- `[filters][updated_at][conditions][$after][0]=2021-12-30T13:52:18.227Z` |

## Query parameters

- `limit` integer
- `page` integer
- `order` 'created_at' | '-created_at' | 'updated_at' | '-updated_at' | 'name' | '-name'
- `created_at` ParameterCreatedBeforeAfter
  - `before` string, date-time — Timestamp representing the date and time before the voucher was created. The value is shown in the ISO 8601 format.
  - `after` string, date-time — Timestamp representing the date and time after the voucher was created. The value is shown in the ISO 8601 format.
- `updated_at` ParameterUpdatedBeforeAfter
  - `before` string, date-time — Timestamp representing the date and time before the voucher was updated. The value is shown in the ISO 8601 format.
  - `after` string, date-time — Timestamp representing the date and time after the voucher was updated. The value is shown in the ISO 8601 format.

## Response `200`

Returns a dictionary with a `data` property that contains an array of promotion stacks across all your campaigns.

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