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

# List ecommerce coupons

`GET /ecommerce/coupons`

## Request

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

Lista cupones ecommerce de la marca autorizada. Permite filtrar por texto y por locales. La data siempre queda limitada al website autorizado por el token.

## Query parameters

- `filter` string
- `storesIds` string[]
- `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` ApiCoupon[]: Items de la lista.
      - `_id` string: ID Justo del cupón.
      - `websiteId` string: ID de la marca dueña del cupón.
      - `code` string: Primer código activo asociado al cupón, si existe.
      - `name` string: Nombre visible del cupón.
      - `description` string: Descripción interna o visible del beneficio.
      - `type` 'percentage' | 'percentageOnDiscount' | 'fixed' | 'fixedOnDelivery' | 'fixedItemPrice': Tipo de descuento.
      - `active` boolean: Indica si el cupón está activo.
      - `percentageOff` number: Porcentaje de descuento para cupones porcentuales.
      - `maxPercentageOffDiscount` number: Tope de descuento para cupones porcentuales.
      - `discountAmount` number: Monto fijo de descuento.
      - `fixedAmount` number: Precio fijo aplicado a productos seleccionados.
      - `fromDate` string, date-time: Fecha desde la que el cupón puede usarse.
      - `endDate` string, date-time: Fecha hasta la que el cupón puede usarse.
      - `maxRedemptions` number: Cantidad máxima de canjes totales.
      - `maxRedemptionsPerUser` number: Cantidad máxima de canjes por usuario.
      - `maxRedemptionsPerUserPerDay` boolean: Si es true, permite máximo un canje diario.
      - `maxRedemptionsPerCode` number: Cantidad máxima de canjes por código.
      - `totalRedemptions` number: Cantidad total de canjes realizados.
      - `onlyForNewUsers` boolean: Si es true, aplica solo a usuarios nuevos.
      - `onlyForProductsWithoutDiscount` boolean: Si es true, no aplica sobre productos con descuento.
      - `requirePhoneVerification` boolean: Si es true, exige teléfono verificado.
      - `requiresCategoriesIds` string[]: Categorías requeridas para aplicar el cupón.
      - `requiresProductsIds` string[]: Productos requeridos para aplicar el cupón.
      - `requiresStoresIds` string[]: Locales donde puede usarse el cupón.
      - `requiresMenusIds` string[]: Menús donde puede usarse el cupón.
      - `requiresPaymentTypes` string[]: Medios de pago requeridos.
      - `requireChannels` string[]: Canales requeridos para usar el cupón.
      - `requiredBINs` string[]: BINs de tarjeta admitidos.
      - `minimumOrderPrice` number: Monto mínimo del pedido.
      - `maximumOrderPrice` number: Monto máximo del pedido.
      - `dontApplyToProductsIds` string[]: Productos excluidos del descuento.
      - `dontApplyDiscountToOptions` boolean: Si es true, no aplica descuento sobre opciones/modificadores.
      - `isHidden` boolean: Si es true, oculta el cupón de listados públicos.
      - `allowedEmails` string[]: Emails autorizados para usar el cupón.
      - `externalId` string: Identificador externo del cupón.
      - `isBirthdayCoupon` boolean: Si es true, es un cupón de cumpleaños.
      - `onlyRedeemOnBirthday` boolean: Si es true, solo se canjea el día del cumpleaños.
      - `autoRecommend` boolean: Si es true, Justo puede recomendarlo automáticamente.
      - `applyDeliveryDiscount` boolean: Si es true, aplica descuento al despacho.
      - `deliveryDiscountValue` number: Valor del descuento de despacho.
      - `deliveryDiscountType` string: Tipo de descuento de despacho.
      - `deliveryDiscountPercentage` number: Porcentaje de descuento de despacho.
      - `maxProductsPerOrder` number: Máximo de productos a los que se aplica el cupón.
      - `createdAt` string, date-time: Fecha de creación.
      - `deletedAt` string, date-time: Fecha de eliminación lógica.
    - `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-06-02** `dd70866e9669`: 1 info
  - endpoint added

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