---
title: "List kitchen orders"
method: GET
path: "/tabs/{storeId}/kds-locations/{kdsLocationId}/orders"
---

# List kitchen orders

`GET /tabs/{storeId}/kds-locations/{kdsLocationId}/orders`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/tabs/{storeId}/kds-locations/{kdsLocationId}/orders`
- Auth: none declared

Lista las comandas procesadas por un centro de cocina, incluyendo sus tiempos operativos y productos asociados. La fecha se filtra por la entrada de la comanda al centro.

## Path parameters

- `storeId` string, required
- `kdsLocationId` string, required

## Query parameters

- `fromDate` string, date-time: Fecha de inicio por entrada a cocina.
- `toDate` string, date-time: Fecha de término por entrada a cocina.
- `page` number: Número de página.
- `limit` number: Número de items por página. Max 100. Por defecto: 10.
- `sortBy` 'createdAt': Campo por el cual se ordenará la lista. Por defecto: "createdAt".
- `sortType` 'asc' | 'desc': Tipo de ordenamiento.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object
    - `items` TabsKDSOrder[]: Items de la lista.
      - `_id` string: ID de la comanda en cocina.
      - `kdsLocationId` string: ID del centro de cocina.
      - `orderId` string: ID de la cuenta o pedido asociado.
      - `enteredAt` string, date-time: Fecha en la que la comanda entró al centro de cocina.
      - `completedAt` string, date-time, nullable: Fecha en la que la comanda fue completada. Null si sigue pendiente.
      - `items` object[]: Productos asociados a la comanda en este centro de cocina.
        - `_id` string: ID del producto dentro de la comanda.
        - `amount` number: Cantidad solicitada del producto.
        - `comment` string: Comentario del producto.
        - `productId` string: ID del producto.
        - `productName` string: Nombre del producto.
        - `productInternalName` string: Nombre interno del producto.
        - `productUnitItemsCount` number: Cantidad de unidades que contiene el producto.
        - `sentToKDSAt` string, date-time: Fecha en la que el producto fue enviado a cocina.
        - `type` 'product' | 'deliveryFee' | 'serviceFee' | 'billingItem': Tipo de item.
    - `hasNextPage` boolean: Indica si hay una página siguiente.
    - `hasPreviousPage` boolean: Indica si hay una página anterior.
    - `totalPages` number: Total de páginas.
    - `totalCount` number: Total de items.

## Other responses

- `400`: Errors

## Changes

- **2026-09-28** `92e123ae68ee`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/tabs/:storeId/kds-locations/:kdsLocationId/orders/get.md)

---

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