---
title: "Listar histórico de alterações"
method: GET
path: "/api/promotions/{promotionId}/logs"
tags: ["Admin API · Promoções"]
---

# Listar histórico de alterações

`GET /api/promotions/{promotionId}/logs`

## Request

- Base URL: `https://sualoja.commerce-wake.tech`
- URL: `https://sualoja.commerce-wake.tech/api/promotions/{promotionId}/logs`
- Auth: HTTP bearer

Retorna as alterações mais recentes registradas para a promoção nos últimos 120 dias, da mais nova para a mais
antiga. Cada registro traz quem alterou (o `client_id`, para aplicações), quando, e uma fotografia da
promoção naquele momento.
            
Permissão: **Cadastro de promoções — visualização e edição**.

## Path parameters

- `promotionId` integer, required

## Query parameters

- `StartDate` string, date-time
- `EndDate` string, date-time
- `DateLog` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13
- `OrderField` string
- `OrderBy` string
- `Page` integer
- `Limit` integer

## Headers

- `x-api-version` '2.0', required

## Response `200`

Registros em `data`. `total` é a quantidade retornada nesta resposta, não o total existente.

- ListingResponseDTOGetPromotionLogsQueryDTO
  - `data` GetPromotionLogsQueryDTO[], nullable: Itens da página.
    - `changeDate` string, date-time: Data e hora da alteração.
    - `user` string, nullable: Autor da alteração, obtido do token (o `client_id`, para aplicações).
    - `payload` string, nullable: String com o JSON completo do registro de histórico.
  - `total` integer, nullable: Total informado pela listagem. Nas rotas de apoio de promoções é a quantidade de itens desta página; o total geral fica em `totalGeneral`.
  - `totalGeneral` integer, nullable: Total de itens que atendem aos filtros, em todas as páginas.
  - `totalActive` integer, nullable: Total de itens ativos, quando a listagem informa.
  - `totalInactive` integer, nullable: Total de itens inativos, quando a listagem informa.
  - `totalArchived` integer, nullable: Total de itens arquivados, quando a listagem informa.
  - `limit` integer, nullable: Tamanho de página usado.
  - `page` integer, nullable: Página retornada, começando em 1.
  - `totalPage` integer, nullable: Quantidade de páginas, quando a listagem informa.
  - `message` string, nullable: Observação opcional sobre a listagem (por exemplo, por que veio vazia). Omitida quando nula.

## Other responses

- `400`: Requisição inválida, incluindo a falta do header x-api-version. O motivo vem em details.
- `401`: Token ausente, inválido ou expirado (SESSION_INVALID), ou sem a permissão exigida (UNAUTHORIZED).
- `500`: Erro inesperado. Tente de novo; se persistir, contate o suporte com o traceId.

---

[API](https://skmtc.dev/fbits/apis/admin-api.md) - [All operations](https://skmtc.dev/fbits/apis/admin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fbits/apis/admin-api/revisions/a37bfd1b0bf3?raw)