---
title: "List order reviews"
method: GET
path: "/ecommerce/reviews"
---

# List order reviews

`GET /ecommerce/reviews`

## Request

- Base URL: `https://api.service.getjusto.com/v3`
- URL: `https://api.service.getjusto.com/v3/ecommerce/reviews`
- Auth: none declared

Lista las valoraciones de pedidos ecommerce de la marca autorizada: nota de la comida, nota del delivery, NPS, motivos, comentarios y preguntas personalizadas. Se ordenan de la más reciente a la más antigua. La data siempre queda limitada a la marca y a los locales de la autorización.

## Query parameters

- `storesIds` string[]: Un arreglo con el ID o ID externo de los locales.
- `fromDate` string, date-time: Incluir valoraciones creadas desde esta fecha.
- `toDate` string, date-time: Incluir valoraciones creadas hasta esta fecha.
- `page` number: Número de página.
- `limit` number: Número de items por página. Max 100. Por defecto: 10.

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object
    - `items` ApiReview[]: Items de la lista.
      - `_id` string: ID de la valoración.
      - `websiteId` string: ID de la marca.
      - `storeId` string: ID del local del pedido.
      - `orderId` string: ID del pedido. Sirve para consultar GET /ecommerce/orders/{orderId}.
      - `orderCode` string: Código del pedido que se muestra en el panel.
      - `orderDate` string, date-time: Fecha de entrega del pedido.
      - `rating` 1 | 2 | 3 | 4 | 5: Nota de la comida (o de los productos, en tiendas), de 1 a 5.
      - `comment` string: Comentario sobre la comida.
      - `ratingReason` ApiReviewRatingReason: Motivo que eligió el cliente para explicar la nota.
        - `value` string: Identificador del motivo.
        - `label` string: Texto que vio el cliente.
        - `resumeLabel` string: Texto corto del motivo, el mismo que muestra el panel.
      - `deliveryRating` 1 | 2 | 3 | 4 | 5: Nota del delivery, de 1 a 5.
      - `deliveryComment` string: Comentario sobre el delivery.
      - `ratingDeliveryReason` ApiReviewRatingReason: Motivo que eligió el cliente para explicar la nota.
        - `value` string: Identificador del motivo.
        - `label` string: Texto que vio el cliente.
        - `resumeLabel` string: Texto corto del motivo, el mismo que muestra el panel.
      - `npsRating` number: Probabilidad de recomendar la marca (NPS), de 0 a 10.
      - `hasManagedDelivery` boolean: Si el despacho lo hizo Justo.
      - `customReviews` ApiCustomReview[]: Respuestas a las preguntas personalizadas de la marca.
        - `reviewQuestionId` string: ID de la pregunta.
        - `question` string: Texto de la pregunta.
        - `rating` 1 | 2 | 3 | 4 | 5: Nota de 1 a 5.
        - `reason` string: Motivo elegido, si la pregunta tiene motivos.
        - `comment` string: Comentario del cliente.
      - `createdAt` string, date-time: Fecha en que el cliente empezó la valoración.
      - `updatedAt` string, date-time: Última modificación de la valoración.
      - `completedAt` string, date-time: Fecha en que el cliente terminó la valoración. Si no viene, el cliente todavía puede modificarla (hasta 2 horas desde la última respuesta).
    - `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-11-01** `4b46b8f3312f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getjusto/apis/justo-api/changes/ecommerce/reviews/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)