---
title: "Get ecommerce coupon"
method: GET
path: "/ecommerce/coupons/{couponId}"
---

# Get ecommerce coupon

`GET /ecommerce/coupons/{couponId}`

## Request

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

Obtiene un cupón ecommerce de la marca autorizada. Puede incluir sus códigos activos usando withCodes=true.

## Path parameters

- `couponId` string, required

## Query parameters

- `withCodes` boolean

## Response `200`

The OpenAPI spec

- object
  - `success` boolean
  - `data` object: Cupón ecommerce de la marca autorizada. La data siempre queda limitada al website autorizado.
    - `_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.
    - `codes` ApiCouponCode[]
      - `_id` string: ID Justo del código.
      - `code` string: Código que ingresa el cliente.
      - `websiteId` string: ID de la marca dueña del código.
      - `couponId` string: ID del cupón al que pertenece.
      - `totalRedemptions` number: Cantidad de canjes realizados con este código.
      - `userEmail` string: Email asociado cuando el código es de uso por email.
      - `sentToEmail` string: Email al que se envió el código, si aplica.
      - `createdAt` string, date-time: Fecha de creación.
      - `deletedAt` string, date-time: Fecha de eliminación lógica.

## 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/:couponId/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)