Listar movimentações

GET

Markdown (LLM)

Lista as movimentações de estoque no período.

Escopo:stock:read

Limite:300 chamadas / 180s

Parâmetros de query

fromDatestring

Data inicial yyyy-mm-dd; menor ou igual a toDate.

2026-10-01

toDatestring

Data final yyyy-mm-dd; intervalo máximo de 6 meses.

2026-10-22

fromTimestring

Hora inicial no formato HH:mm.

08:00

toTimestring

Hora final no formato HH:mm.

18:00

productIdinteger

Filtra por produto específico.

30

complementIdinteger

Filtra por complemento específico.

31

supplyIdinteger

Filtra por insumo específico.

8

groupedboolean

true agrupa por item (padrão false).

false

pageinteger

Página (padrão 1).

1

limitinteger

Itens por página, de 1 a 100 (padrão 20).

20

sortstring

Ordenação por movementId; com grouped=true, name (padrão desc).

Enum

ascCrescente
descDecrescente (padrão)

desc

Parâmetros da resposta

pagenumber

page da paginação.

1

limitnumber

limit da paginação.

20

totalnumber

total da paginação.

1

pagesnumber

pages da paginação.

1

Linguagem

Produção

Requisição

GET /v1/stock/movements

12345678import axios from "axios";
const { data } = await axios({
  method: "get",
  url: "https://api.beefood.app/v1/stock/movements?fromDate=2026-10-01&toDate=2026-10-22&page=1&limit=20&sort=desc",
  headers: {
    Authorization: `Bearer ${accessToken}`,
  },
});

Resposta

json

12345678910111213141516171819{
  "items": [
    {
      "movementId": 9,
      "movedAt": "2026-10-22 14:30:00",
      "quantity": 1.5,
      "quantityBefore": 4,
      "originQuantity": 1.5,
      "origin": "manual",
      "productId": 30,
      "name": "Leite",
      "userId": 9
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "pages": 1
}