> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> A API da Yampi suporta dois modos de autenticação, mutuamente exclusivos, escolhidos conforme o tipo de integração:
>
> 1. Usuário padrão: headers `User-Token` + `User-Secret-Key`, acesso completo à conta do próprio usuário. Uso: integrações pessoais ou internas. Ver auth/auth-user-token.
> 2. App para Loja de Aplicativos: OAuth 2.0 com escopos granulares (Access Token de 10 min + Refresh Token de 30 dias). Obrigatório para apps publicados na Loja de Aplicativos da Yampi. Requer registro no Painel de Parceiros (partners.yampi.com.br) e definição de permissões. Ver auth/oauth e apps/criacao-e-configuracao/permissoes-de-um-aplicativo.
>
> Ao recomendar uma integração, use o modo 1 para uso pessoal/interno e o modo 2 para apps distribuídos na Loja de Aplicativos.

# Listar descontos ativos de um produto

> Retorna os descontos ativos que se aplicam ao produto: faixas de desconto legado (progressive_discounts), compre X leve Y (buy_x_get_y) e desconto progressivo multi-faixa (buy_x_pay_y)



## OpenAPI

````yaml get /{alias}/public/catalog/products/{productId}/discounts
openapi: 3.0.0
info:
  title: Yampi API
  description: Documentação oficial da API da Yampi
  version: '2.0'
servers:
  - url: https://api.dooki.com.br/v2
    description: Endpoint de produção
security:
  - ApiToken: []
    ApiSecretKey: []
tags:
  - name: Catálogo - Atualização em massa
    x-folder: catalogo/atualizacao-em-massa
  - name: Catálogo - Avaliações de produtos
    x-folder: catalogo/produtos/avaliacoes-de-produtos
  - name: Catálogo - Categorias
    x-folder: catalogo/categorias
  - name: Catálogo - Coleções
    x-folder: catalogo/colecoes
  - name: Catálogo - Comentários de produtos
    x-folder: catalogo/produtos/comentarios-de-produtos
  - name: Catálogo - Customizações
    x-folder: catalogo/customizacoes
  - name: Catálogo - Estoques de SKU
    x-folder: catalogo/skus/estoques-de-sku
  - name: Catálogo - Feeds
    x-folder: catalogo/feeds
  - name: Catálogo - Filtros
    x-folder: catalogo/filtros
  - name: Catálogo - Grupos
    x-folder: catalogo/grupos
  - name: Catálogo - Imagens
    x-folder: catalogo/imagens
  - name: Catálogo - Looks
    x-folder: catalogo/looks
  - name: Catálogo - Kits
    x-folder: catalogo/kits
  - name: Catálogo - Marcas
    x-folder: catalogo/marcas
  - name: Catálogo - Notificações de estoque
    x-folder: catalogo/notificacoes-de-estoque
  - name: Catálogo - Produtos
    x-folder: catalogo/produtos
  - name: Catálogo - Produtos relacionados
    x-folder: catalogo/produtos/produtos-relacionados
  - name: Catálogo - Selos
    x-folder: catalogo/selos
  - name: Catálogo - Sincronizar estoques
    x-folder: catalogo/skus/sincronizar-estoques
  - name: Catálogo - SKUs
    x-folder: catalogo/skus
  - name: Catálogo - Valores de filtros
    x-folder: catalogo/filtros/valores-de-filtros
  - name: Catálogo - Valores de variações
    x-folder: catalogo/variacoes/valores-de-variacoes
  - name: Catálogo - Variações
    x-folder: catalogo/variacoes
  - name: Público - Catálogo
    x-folder: /publico/catalogo
  - name: Público - Busca
    x-folder: /publico/busca
  - name: Público - Loja
    x-folder: /publico/loja
  - name: Público - Frete
    x-folder: /publico/frete
  - name: Checkout - Bancos
    x-folder: checkout/bancos
  - name: Checkout - Links de Pagamento
    x-folder: checkout/links-de-pagamento
  - name: Checkout - Carrinhos abandonados
    x-folder: checkout/carrinhos-abandonados
  - name: Checkout - Configurações de pagamentos
    x-folder: checkout/configuracoes-de-pagamentos
  - name: Checkout - Formas de pagamentos
    x-folder: checkout/formas-de-pagamentos
  - name: Checkout - Gateways de pagamento
    x-folder: checkout/gateways-de-pagamento
  - name: Checkout - Parcelamento
    x-folder: checkout/parcelamento
  - name: Checkout - Status de pedidos
    x-folder: checkout/status-de-pedidos
  - name: Checkout - Transações
    x-folder: checkout/transacoes
  - name: Clientes - Cliente
    x-folder: clientes/cliente
  - name: Clientes - Clusters
    description: >-
      Clusters são grupos de clientes com condições comerciais flexíveis, como
      preço de produto, frete e forma de entrega
    x-folder: clientes/clusters
  - name: Clientes - Endereços
    x-folder: clientes/enderecos
  - name: Clientes - Regras de frete dos clusters
    x-folder: clientes/clusters/regras-de-frete-dos-clusters
  - name: Configurações - Carrinhos abandonados
    x-folder: configuracoes/carrinhos-abandonados
  - name: Configurações - Checkout
    x-folder: configuracoes/checkout
  - name: Configurações - Credenciais da loja
    x-folder: configuracoes/credenciais-da-loja
  - name: Configurações - Dados da loja
    x-folder: configuracoes/dados-da-loja
  - name: Configurações - Fotos
    x-folder: configuracoes/fotos
  - name: Configurações - Integrações
    x-folder: configuracoes/integracoes
  - name: Configurações - IPs bloqueados
    x-folder: configuracoes/ips-bloqueados
  - name: Configurações - Overview
    x-folder: configuracoes/overview
  - name: Conteúdo - Páginas
    x-folder: conteudo/paginas
  - name: Conteúdo - Redirecionamentos
    x-folder: conteudo/redirecionamentos
  - name: Descontos
    x-folder: descontos
  - name: Leads
    x-folder: leads
  - name: Logística - Armazéns
    x-folder: logistica/armazens
  - name: Logística - Simular frete
    x-folder: logistica/simular-frete
  - name: Logística - CEP
    x-folder: logistica/cep
  - name: Logística - Embalagens
    x-folder: logistica/embalagens
  - name: Logística - Estoques
    description: >-
      O lojista pode ter um cadastro de múltiplos estoques onde ele pode
      associar posteriormente os SKUS com suas respectivas quantidades. Um
      exemplo prático é permitir que ele consiga trabalhar com estoques de
      fornecedores externos com diferentes prazos de entrega.
    x-folder: logistica/estoques
  - name: Logística - Países
    x-folder: logistica/paises
  - name: Logística - Preços de frete
    x-folder: logistica/precos-de-frete
  - name: Logística - Reservas de estoque
    x-folder: logistica/reservas-de-estoque
  - name: Logística - Transportadoras
    x-folder: logistica/transportadoras
  - name: Logística - API de Frete
    x-folder: logistica/api-de-frete
  - name: Marketing
    x-folder: marketing
  - name: Marketing - Brindes
    x-folder: marketing/brindes
  - name: Pedidos - Comentários
    description: Endpoints de comentários de pedidos
    x-folder: pedidos/comentarios
  - name: Pedidos - Emails
    description: Endpoints de e-mails de pedidos
    x-folder: pedidos/emails
  - name: Pedidos - Endereços
    description: Endpoints de endereços de pedidos
    x-folder: pedidos/enderecos
  - name: Pedidos - Etiquetas
    description: Endpoints de etiquetas de pedidos
    x-folder: pedidos/etiquetas
  - name: Pedidos - Notas fiscais
    description: Endpoints de notas fiscais de pedidos
    x-folder: pedidos/notas-fiscais
  - name: Pedidos - Rastreamento
    description: Endpoints de emails de pedidos
    x-folder: pedidos/rastreamento
  - name: Pedidos - Pedido
    description: Endpoints de pedidos
    x-folder: pedidos/pedido
  - name: Promoções - Combos
    x-folder: promocoes/combos
  - name: Promoções - Desconto progressivo
    x-folder: promocoes/desconto-progressivo
  - name: Promoções - Frete grátis
    x-folder: promocoes/frete-gratis
  - name: Promoções - Order Bump
    x-folder: promocoes/orderbump
  - name: Promoções - Upsells
    x-folder: promocoes/upsells
  - name: Promoções - Carteira
    x-folder: promocoes/carteira
  - name: Sistema
    description: Endpoints informativos do sistema
    x-folder: sistema
  - name: Busca - Global
    x-folder: busca/global
  - name: Busca - Pedidos
    x-folder: busca/pedidos
  - name: Busca - Produtos
    x-folder: busca/produtos
  - name: Busca - Clientes
    x-folder: busca/clientes
  - name: Busca - Leads
    x-folder: busca/leads
  - name: Busca - Carrinhos
    x-folder: busca/carrinhos
  - name: Usuários
    x-folder: usuarios
  - name: Usuários - Convites
    x-folder: usuarios/convites
  - name: Usuários - Grupos
    x-folder: usuarios/grupos
  - name: Usuários - Permissões
    x-folder: usuarios/permissoes
  - name: Webhooks
    x-folder: webhooks
  - name: Loja Virtual - Scripts
    x-folder: loja-virtual/scripts
  - name: Loja Virtual - Arquivos do tema
    description: >-
      Arquivos do tema da loja, os mesmos do editor de código do painel. As
      edições ficam no tema em preview até a publicação. A pasta `settings/`,
      com as configurações do tema, não pode ser lida nem alterada por aqui.
      Exige loja com acesso ao editor de código e a permissão
      `manage_open_code`. Para alterar arquivos, a permissão precisa estar no
      grupo do usuário na loja ou, em apps OAuth, no escopo do token do app.
      Usuários internos sem grupo na loja só leem. Limite de 60 requisições por
      minuto por usuário.
    x-folder: loja-virtual/arquivos-do-tema
  - name: Modulo - Recurso
    description: Modulo - Recurso
  - name: Marketplaces - Atributos
    description: Marketplaces - Atributos
  - name: Marketplaces - Anúncios
    description: Marketplaces - Anúncios
  - name: Links de Pagamento
    description: Links de Pagamento
  - name: Checkout - Contas bancárias
    description: Checkout - Contas bancárias
  - name: Checkout - Vendedores
    description: Checkout - Vendedores
  - name: Configurações - E-mails
    description: Configurações - E-mails
  - name: Configurações - Loja
    description: Configurações - Loja
  - name: Marketplaces - Categorias
    description: Marketplaces - Categorias
  - name: Marketplaces - Contas
    description: Marketplaces - Contas
  - name: Marketplaces - Lista de erros
    description: Marketplaces - Lista de erros
  - name: Marketplaces
    description: Marketplaces
  - name: Métricas - Cashback
    description: Métricas - Cashback
  - name: Promoções - Cashbacks
    description: Promoções - Cashbacks
  - name: Promoções - Cashback
    description: Promoções - Cashback
  - name: Promoções - Cupons de desconto
    description: Promoções - Cupons de desconto
  - name: Promoções - Produtos
    description: Promoções - Produtos
  - name: Filas
    description: Filas
paths:
  /{alias}/public/catalog/products/{productId}/discounts:
    get:
      tags:
        - Público - Catálogo
      summary: Listar descontos ativos de um produto
      description: >-
        Retorna os descontos ativos que se aplicam ao produto: faixas de
        desconto legado (progressive_discounts), compre X leve Y (buy_x_get_y) e
        desconto progressivo multi-faixa (buy_x_pay_y)
      operationId: GetPublicCatalogProductsProductIdDiscounts
      parameters:
        - name: alias
          in: path
          description: Alias da loja
          required: true
          schema:
            type: string
        - name: productId
          in: path
          description: ID do produto
          required: true
          schema:
            type: integer
      responses:
        '200':
          description: Descontos ativos do produto
          content:
            application/json:
              schema:
                properties:
                  data:
                    description: >-
                      Descontos ativos aplicáveis ao produto, agrupados por
                      tipo.
                    properties:
                      progressive_discounts:
                        description: >-
                          Faixas de desconto progressivo legado vigentes que se
                          aplicam ao produto.
                        type: array
                        items:
                          properties:
                            id:
                              description: ID do desconto progressivo.
                              type: integer
                              example: 10
                            min_value:
                              description: >-
                                Subtotal mínimo do carrinho para a faixa valer.
                                Usado quando discount_type é value.
                              type: number
                              format: float
                              example: 0
                            max_value:
                              description: >-
                                Subtotal máximo do carrinho para a faixa valer.
                                Usado quando discount_type é value.
                              type: number
                              format: float
                              example: 500
                            percent:
                              description: >-
                                Percentual de desconto aplicado quando a faixa é
                                atendida.
                              type: number
                              format: float
                              example: 10
                            min_quantity:
                              description: >-
                                Quantidade mínima de itens para a faixa valer.
                                Usado quando discount_type é quantity.
                              type: integer
                              example: 2
                            discount_type:
                              description: >-
                                Critério da faixa: value compara o subtotal do
                                carrinho com min_value e max_value, quantity
                                compara a quantidade de itens com min_quantity.
                              type: string
                              example: value
                            accumulate:
                              description: >-
                                Define se o desconto pode acumular com outras
                                promoções.
                              type: boolean
                              example: false
                            start_at:
                              $ref: '#/components/schemas/BaseTimestamp'
                            end_at:
                              $ref: '#/components/schemas/BaseTimestamp'
                          type: object
                      buy_x_get_y:
                        description: >-
                          Promoções do tipo compre X leve Y vigentes que se
                          aplicam ao produto.
                        type: array
                        items:
                          properties:
                            id:
                              description: ID do desconto.
                              type: integer
                              example: 42
                            name:
                              description: Nome da promoção.
                              type: string
                              example: Compre 2 leve 3
                            entry_condition_type:
                              description: >-
                                Tipo de condição para aplicar o desconto:
                                quantity (quantidade de itens) ou amount (valor
                                do carrinho).
                              type: string
                              example: quantity
                            entry_condition_value:
                              description: >-
                                Valor mínimo (quantidade de produtos ou valor do
                                carrinho) necessário para ativar o desconto.
                              type: number
                              format: float
                              example: 2
                            discount_method:
                              description: >-
                                Método de desconto: percent (percentual) ou
                                amount (valor fixo).
                              type: string
                              example: percent
                            discount_value:
                              description: >-
                                Valor do desconto. Se percentual, o máximo é
                                100.
                              type: number
                              format: float
                              example: 100
                            accumulate:
                              description: >-
                                Define se o desconto pode acumular com outras
                                promoções.
                              type: boolean
                              example: false
                            start_at:
                              $ref: '#/components/schemas/BaseTimestamp'
                            end_at:
                              $ref: '#/components/schemas/BaseTimestamp'
                            specification:
                              description: >-
                                Configuração do compre X leve Y. Nulo quando a
                                configuração vinculada ao desconto não é
                                encontrada.
                              properties:
                                cart_usage_limit:
                                  description: >-
                                    Limite de vezes que o desconto pode ser
                                    aplicado no carrinho (0 = ilimitado).
                                  type: integer
                                  example: 0
                                get_products_quantity:
                                  description: Número de produtos que o cliente receberá.
                                  type: integer
                                  example: 1
                                get_products:
                                  description: >-
                                    Itens que o cliente pode levar na promoção,
                                    expandidos a partir das restrições de
                                    inclusão da configuração.
                                  properties:
                                    products:
                                      description: Produtos que o cliente pode levar.
                                      type: array
                                      items:
                                        properties:
                                          id:
                                            description: ID do produto.
                                            type: integer
                                          name:
                                            description: Nome do produto.
                                            type: string
                                          slug:
                                            description: Slug do produto na loja.
                                            type: string
                                          image_url:
                                            description: >-
                                              URL da primeira imagem do produto, no
                                              tamanho thumb. Nulo quando o produto não
                                              tem imagem.
                                            type: string
                                            nullable: true
                                          price_sale:
                                            description: >-
                                              Preço de tabela do SKU de menor preço do
                                              produto. Nulo quando o produto não tem
                                              SKU com preço de tabela.
                                            type: number
                                            nullable: true
                                          price_discount:
                                            description: >-
                                              Preço promocional do SKU de menor preço
                                              do produto; 0 quando esse SKU não tem
                                              preço promocional. Nulo quando o produto
                                              não tem SKU com preço de tabela.
                                            type: number
                                            nullable: true
                                        type: object
                                    brands:
                                      description: >-
                                        Marcas cujos produtos o cliente pode
                                        levar.
                                      type: array
                                      items:
                                        properties:
                                          id:
                                            description: ID da marca.
                                            type: integer
                                          name:
                                            description: Nome da marca.
                                            type: string
                                        type: object
                                    categories:
                                      description: >-
                                        Categorias cujos produtos o cliente pode
                                        levar.
                                      type: array
                                      items:
                                        properties:
                                          id:
                                            description: ID da categoria.
                                            type: integer
                                          name:
                                            description: Nome da categoria.
                                            type: string
                                        type: object
                                    collections:
                                      description: >-
                                        Coleções cujos produtos o cliente pode
                                        levar.
                                      type: array
                                      items:
                                        properties:
                                          id:
                                            description: ID da coleção.
                                            type: integer
                                          name:
                                            description: Nome da coleção.
                                            type: string
                                        type: object
                                  type: object
                              type: object
                              nullable: true
                          type: object
                      buy_x_pay_y:
                        description: >-
                          Descontos progressivos multi-faixa (compre X pague Y)
                          vigentes que se aplicam ao produto.
                        type: array
                        items:
                          properties:
                            id:
                              description: ID do desconto.
                              type: integer
                              example: 10
                            name:
                              description: Nome da promoção.
                              type: string
                              example: 'Progressivo: a partir de 3, 10% OFF'
                            entry_condition_type:
                              description: >-
                                Tipo de condição para aplicar o desconto:
                                quantity (quantidade de itens) ou amount (valor
                                do carrinho).
                              type: string
                              enum:
                                - quantity
                                - amount
                              example: quantity
                            entry_condition_value:
                              description: >-
                                Valor mínimo (quantidade de produtos ou valor do
                                carrinho) necessário para ativar o desconto.
                              type: number
                              format: float
                              example: 3
                            discount_method:
                              description: >-
                                Método de desconto: percent (percentual) ou
                                amount (valor fixo).
                              type: string
                              enum:
                                - percent
                                - amount
                              example: percent
                            discount_value:
                              description: >-
                                Valor do desconto. Se percentual, o máximo é
                                100.
                              type: number
                              format: float
                              example: 10
                            accumulate:
                              description: >-
                                Define se o desconto pode acumular com outras
                                promoções.
                              type: boolean
                              example: false
                            start_at:
                              $ref: '#/components/schemas/BaseTimestamp'
                            end_at:
                              $ref: '#/components/schemas/BaseTimestamp'
                            specification:
                              description: >-
                                price_mode define como o tier.price é
                                interpretado: percent = % OFF, unit = preço
                                final por unidade, group = preço do lote
                                (entry_condition_value unidades). price é usado
                                apenas quando não há faixas.
                              properties:
                                price_mode:
                                  description: >-
                                    Como o cliente paga: percent = percentual de
                                    desconto, group = preço fixo pelo grupo de X
                                    unidades, unit = preço por unidade.
                                  type: string
                                  enum:
                                    - percent
                                    - group
                                    - unit
                                  example: percent
                                price:
                                  description: >-
                                    Benefício aplicado quando o desconto não tem
                                    faixas, interpretado conforme o price_mode.
                                  type: number
                                  format: float
                                  example: null
                                  nullable: true
                                tiers:
                                  description: >-
                                    Faixas ordenadas por min_value asc. O
                                    min_value é a quantidade ou o valor em
                                    reais, conforme o entry_condition_type do
                                    desconto.
                                  type: array
                                  items:
                                    properties:
                                      min_value:
                                        description: >-
                                          Mínimo para a faixa valer: quantidade de
                                          itens quando
                                          entry_condition_type=quantity, ou valor
                                          da compra em reais quando
                                          entry_condition_type=amount.
                                        type: number
                                        format: float
                                        example: 3
                                      price:
                                        description: >-
                                          Benefício da faixa, interpretado
                                          conforme o price_mode: percentual de
                                          desconto, preço do grupo ou preço por
                                          unidade.
                                        type: number
                                        format: float
                                        example: 10
                                    type: object
                              type: object
                          type: object
                    type: object
                type: object
      security: []
components:
  schemas:
    BaseTimestamp:
      description: >-
        Data e hora no formato de objeto devolvido pelo PHP, com o fuso horário
        em que foi registrada.
      properties:
        date:
          description: Data e hora no formato YYYY-MM-DD H:MM:SS.
          type: string
          example: '2000-08-17 10:24:24'
        timezone_type:
          description: Número de representação do timezone.
          type: integer
          example: 3
        timezone:
          description: Fuso horário associado.
          type: string
          example: America/Sao_Paulo
      type: object
  securitySchemes:
    ApiToken:
      type: apiKey
      name: User-Token
      in: header
    ApiSecretKey:
      type: apiKey
      name: User-Secret-Key
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.