> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getjusto.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List ecommerce coupon codes

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

Lista los códigos asociados a un cupón ecommerce de la marca autorizada. Sirve para auditar uso, revisar códigos disponibles y buscar códigos específicos por texto.

La respuesta viene paginada. Para descargas completas desde Justo Admin MCP, usa `generate_data_file`; para una vista rápida usa `get_data`.


## OpenAPI

````yaml get /ecommerce/coupons/{couponId}/codes
openapi: 3.1.0
info:
  title: Justo API
  version: 3.0.0
servers:
  - url: https://api.service.getjusto.com/v3
    description: Production server
security: []
paths:
  /ecommerce/coupons/{couponId}/codes:
    get:
      summary: List ecommerce coupon codes
      description: Lista los códigos activos de un cupón ecommerce de la marca autorizada.
      parameters:
        - in: path
          name: couponId
          required: true
          schema:
            type: string
          description: ID Justo o externalId del cupón.
        - in: query
          name: filter
          schema:
            type: string
          description: Texto para buscar por código.
        - in: query
          name: page
          required: false
          schema:
            type: number
            example: 1
            description: Número de página.
        - in: query
          name: limit
          required: false
          schema:
            type: number
            example: 10
            description: 'Número de items por página. Max 100. Por defecto: 10.'
      responses:
        '200':
          description: The OpenAPI spec
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  data:
                    type: object
                    properties:
                      items:
                        type: array
                        items:
                          $ref: '#/components/schemas/apiCouponCode'
                        description: Items de la lista.
                      hasNextPage:
                        type: boolean
                        description: Indica si hay una página siguiente.
                      hasPreviousPage:
                        type: boolean
                        description: Indica si hay una página anterior.
                      totalPages:
                        type: number
                        description: Total de páginas.
                      totalCount:
                        type: number
                        description: Total de items.
        '400':
          description: Errors
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: 'false'
                  error:
                    type: object
                    properties:
                      error:
                        type: string
                        example: error
                      message:
                        type: string
                        example: The request has an error
components:
  schemas:
    apiCouponCode:
      type: object
      description: Código canjeable asociado a un cupón ecommerce.
      properties:
        _id:
          type: string
          description: ID Justo del código.
        code:
          type: string
          description: Código que ingresa el cliente.
        websiteId:
          type: string
          description: ID de la marca dueña del código.
        couponId:
          type: string
          description: ID del cupón al que pertenece.
        totalRedemptions:
          type: number
          description: Cantidad de canjes realizados con este código.
        userEmail:
          type: string
          description: Email asociado cuando el código es de uso por email.
        sentToEmail:
          type: string
          description: Email al que se envió el código, si aplica.
        createdAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de creación.
        deletedAt:
          type: string
          example: '2020-01-01T00:00:00.000Z'
          format: date-time
          description: Fecha de eliminación lógica.

````