---
title: "List stores"
method: GET
path: "/ecommerce/stores"
---

# List stores

`GET /ecommerce/stores`

## Request

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

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` ApiStore[]
    - `_id` string: ID Justo del local.
    - `websiteId` string: ID de la marca a la que pertenece el local.
    - `name` string: Nombre del local.
    - `acceptDelivery` boolean: Indica si el local acepta pedidos con despacho.
    - `acceptServe` boolean: Indica si el local acepta pedidos para servir en mesa.
    - `acceptGo` boolean: Indica si el local acepta pedidos para retiro.
    - `currentPreparationDuration` number: Tiempo actual de preparación en minutos.
    - `currentDeliveryDuration` number: Tiempo actual estimado de despacho en minutos.
    - `phone` string: Teléfono del local.
    - `address` ApiStoreAddress: Dirección del local.
      - `_id` string: ID de la dirección.
      - `placeId` string: ID del lugar asociado a la dirección.
      - `address` string: Dirección principal en formato legacy.
      - `addressLine2` string: Departamento, oficina u otra información complementaria.
      - `addressSecondary` string: Comuna, ciudad o referencia secundaria de la dirección.
      - `streetAddress` string: Calle y número normalizados.
      - `extendedAddress` string: Información complementaria normalizada.
      - `locality` string: Comuna o localidad.
      - `region` string: Región o estado.
      - `postalCode` string: Código postal.
      - `countryCode` string: Código de país ISO 3166-1 alpha-2.
      - `countryName` string: Nombre del país.
      - `location` object: Coordenadas geográficas del local.
        - `lat` number: Latitud.
        - `lng` number: Longitud.
    - `externalId` string: ID externo del local configurado por la marca.
    - `timezone` string: Zona horaria IANA del local.
    - `schedule` ApiStoreSchedule: Horario de atención del local.
      - `closedUntilDate` string, date-time: Fecha hasta la que el local está cerrado temporalmente. Si es null, no hay cierre temporal activo.
      - `availableAtPeriods` boolean: Si es false, el local atiende todo el día y no se aplican openPeriods ni specialPeriods. Si es true, atiende sólo en esos bloques; si openPeriods está vacío, atiende todo el día en los días sin horario especial.
      - `openPeriods` ApiStoreSchedulePeriod[]: Bloques horarios semanales en que el local atiende.
        - `daysOfWeek` integer[], required: Días de la semana en que aplica el bloque: 1 es lunes y 7 es domingo.
        - `fromMinute` integer, required: Minuto del día en que comienza el bloque. 600 son las 10:00.
        - `toMinute` integer, required: Minuto del día en que termina el bloque, mayor que fromMinute. 1440 son las 24:00. Para un horario que cruza la medianoche usa dos bloques.
      - `specialPeriods` ApiStoreSpecialPeriod[]: Horarios especiales por fecha, como feriados con horario reducido.
        - `days` string[], required: Fechas en que aplica el horario especial.
        - `fromMinute` integer, required: Minuto del día en que comienza el bloque.
        - `toMinute` integer, required: Minuto del día en que termina el bloque, mayor que fromMinute.
      - `closedDays` string[]: Días completos en que el local está cerrado, guardados como el inicio del día en la zona horaria del local.
      - `timezone` string: Zona horaria IANA usada para interpretar el horario.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 6 info
  - added the optional property `data/items/schedule/availableAtPeriods` to the response with the `200` status
  - added the optional property `data/items/schedule/specialPeriods` to the response with the `200` status
  - added the optional property `data/items/schedule/timezone` to the response with the `200` status
  - the response property `data/items/schedule/openPeriods/items/daysOfWeek` became required for the status `200`
  - …2 more
- **2026-05-20** `623b88f1e9f3`: 1 info
  - added the optional property `data/items/timezone` to the response with the `200` status
- **2026-05-18** `39f0eb0b2640`: 1 info
  - endpoint added

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