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

# List modifiers

`GET /ecommerce/modifiers`

## Request

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

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` ApiListingModifier[]
    - `modifierId` string: ID Justo del modificador.
    - `importId` string: ID de importación del modificador.
    - `name` string: Nombre del modificador.
    - `description` string: Descripción del modificador.
    - `shortName` string: Nombre corto del modificador.
    - `internalName` string: Nombre interno del modificador.
    - `min` number: Cantidad mínima de opciones.
    - `max` number: Cantidad máxima de opciones.
    - `optional` boolean: Indica si el modificador es opcional.
    - `externalId` string: ID externo configurado por la marca.
    - `metadata` object: Metadata del item escrita por API v3.
    - `optionIds` string[]: IDs de opciones asociadas.
    - `options` ApiModifierOption[]: Opciones asociadas al modificador.
      - `optionId` string: ID Justo de la opción.
      - `importId` string: ID de importación de la opción.
      - `name` string: Nombre de la opción.
      - `internalName` string: Nombre interno de la opción.
      - `max` number: Cantidad máxima seleccionable.
      - `externalId` string: ID externo configurado por la marca.
      - `metadata` object: Metadata del item escrita por API v3.
      - `menus` object[]: Precio y disponibilidad en cada menú. El cliente ve sólo los del menú que aplica en su pedido; ver GET /ecommerce/prices.
        - `menuId` string: ID Justo del menú (_id en GET /ecommerce/prices).
        - `price` number: Precio base en este menú. Si el item no tiene configuración en este menú, es 0 y available no viene.
        - `discount` number, nullable: Precio con descuento: el precio final rebajado, no un monto ni un porcentaje. null si no tiene. Si en el administrador se guardaron varios descuentos seguidos, es el primero, pero el cliente paga el último.
        - `available` boolean: true si se vende en este menú. Si es false o no viene, no se vende: el item no aparece mientras se use este menú, salvo que tenga un mensaje de no disponible en el administrador; entonces aparece con ese mensaje, pero no se puede comprar.
        - `externalId` string: ID externo del producto en este menú: el de reemplazo si se configuró; si no, el externalId del producto.

## Other responses

- `400`: Errors

## Changes

- **2026-10-31** `4ad06bd631ce`: 1 breaking, 3 warning
  - the response property `data/items/options/items/menus/items/discount` became nullable for the status `200`
  - removed the optional property `data/items/options/items/menus/items/basePrice` from the response with the `200` status
  - removed the optional property `data/items/options/items/menus/items/discounts` from the response with the `200` status
  - removed the optional property `data/items/options/items/menus/items/metadata` from the response with the `200` status
- **2026-07-22** `d9d38def2cf6`: 1 info
  - endpoint added
- **2026-06-01** `6788b092513b`: 1 breaking
  - api path removed without deprecation
- **2026-05-18** `39f0eb0b2640`: 1 info
  - endpoint added

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