---
title: "Listar promoções"
method: GET
path: "/{alias}/pricing/promotions"
tags: ["Promoções - Produtos"]
---

# Listar promoções

`GET /{alias}/pricing/promotions`

Lista todas as promoções

## Path parameters

- `alias` string, required

## Request body

- PromotionRequest — Dados para criação ou atualização de uma promoção
  - `active` boolean, required — Status da promoção
  - `all_products` boolean, required — Aplicar em todos os produtos
  - `utm_only` boolean, required — Exclusivo para UTM
  - `highlight_on_menu` boolean — Destacar no menu
  - `accumulate` boolean — Permite acumular com outras promoções
  - `price_attribute` 'price_sale' | 'price_discount', required — Atributo de preço para aplicar desconto
  - `name` string, required — Nome da promoção
  - `value` number, float, required — Valor do desconto
  - `utm_source` string — Origem UTM
  - `utm_campaign` string — Campanha UTM
  - `start_at` string, date-time, required — Data e hora de início
  - `end_at` string, date-time, required — Data e hora de término
  - `collections_ids` integer[] — IDs das coleções
  - `brands_ids` integer[] — IDs das marcas
  - `categories_ids` integer[] — IDs das categorias
  - `banners_ids` integer[] — IDs dos banners

## Response `200`

Lista de promoções

- object — Representa uma paginação com meta
  - `data` Promotion[]
    - `id` integer
    - `active` boolean
    - `all_products` boolean
    - `utm_only` boolean
    - `highlight_on_menu` boolean
    - `accumulate` boolean
    - `price_attribute` string
    - `name` string
    - `expired` boolean
    - `url` string, uri
    - `slug` string
    - `value` number, float
    - `utm_source` string
    - `utm_campaign` string
  - `meta` object
    - `pagination` object
      - `total` integer
      - `count` integer
      - `per_page` integer
      - `current_page` integer
      - `total_pages` integer
      - `links` object
        - `previous` string
        - `next` string

## Other responses

- `400` — Requisição inválida

---

[API](https://skmtc.net/yampi/apis/yampi-api.md) · [All operations](https://skmtc.net/yampi/apis/yampi-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yampi/yampi-api/revisions/fa16c50bef09/schema)