Listar promoções ativas
GET/v1/promotions
Retorna todas as promoções atualmente válidas para sua empresa: dentro do seu intervalo de datas, publicadas no seu menu digital e com resgates restantes. Inclui o código do cupom, o desconto, a quais produtos e tipos de serviço ela se aplica, e qualquer agenda semanal.
Promoções com agenda semanal são incluídas mesmo fora da sua janela horária diária — verifique o campo schedule se precisar saber se uma delas é resgatável neste exato momento.
Uma promoção carrega um desconto, não uma segunda lista de preços. Para um preço antes/depois por produto, leia price e original_price nas variantes retornadas por GET /v1/menu/products/{id}.
Request
Responses
- 200
- 401
- 403
- 404
- 422
As promoções atualmente válidas.
Não autenticado — a requisição não possui uma credencial, ou o token Bearer / API key é inválido, expirou ou foi revogado.
Escopo insuficiente — a credencial está autenticada, mas não possui um escopo exigido pelo endpoint.
Não encontrado — nenhum recurso corresponde ao id no caminho (ou ele pertence a outra empresa).
Falha de validação — o corpo da requisição falhou na validação do schema. errors[] lista todos os campos com problema.