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

# List ecommerce coupon codes

`GET /ecommerce/coupons/{couponId}/codes`

## Request

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

Lista los códigos activos de un cupón ecommerce de la marca autorizada.

## Path parameters

- `couponId` string, required

## Query parameters

- `filter` 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` ApiCouponCode[]: Items de la lista.
      - `_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.
    - `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/:couponId/codes/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)