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

# Listar

> Lista los cupones asociados a una promoción.



## OpenAPI

````yaml /api/openapi.json get /promotions/{promotionId}/coupons
openapi: 3.1.0
info:
  title: Riqra API
  version: '1.0'
  contact:
    email: soporte@riqra.com
    url: https://www.riqra.com/
    name: Riqra Support
  description: >-
    Usando nuestra API puedes integrar tu ERP o tu sistema actual de
    administración con [Riqra](https://www.riqra.com/).
servers:
  - url: https://sandbox.api.riqra.com
    description: Sandbox
  - description: Producción
    url: https://api.riqra.com
security:
  - API Key: []
tags:
  - name: Almacenes
  - name: Banners
  - name: Categorías
  - name: Clientes
  - name: Clientes - Direcciones
  - name: Cobertura
  - name: Comercio
  - name: Cupones
  - name: Inventario
  - name: Líneas de Crédito
  - name: Lista de Precios
  - name: Lista de Precios - Precios
  - name: Marcas
  - name: Pedidos
  - name: Productos
  - name: Productos Sugeridos
  - name: Promociones
  - name: Stock
  - name: Subcategorías
  - name: Variantes
paths:
  /promotions/{promotionId}/coupons:
    parameters:
      - schema:
          type: number
        name: promotionId
        in: path
        required: true
    get:
      tags:
        - Cupones
      summary: Listar
      description: Lista los cupones asociados a una promoción.
      operationId: get-promotions-promotionId-coupons
      parameters:
        - schema:
            type: integer
          in: query
          name: limit
        - schema:
            type: integer
          in: query
          name: page
      responses:
        '200':
          description: OK
          content:
            application/xml:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: number
                        code:
                          type: string
                        useCount:
                          type: number
                        usageLimit:
                          type:
                            - number
                            - 'null'
                        limitPerUser:
                          type:
                            - number
                            - 'null'
                        startDate:
                          type: string
                        expirationDate:
                          type: string
                  pagination:
                    $ref: '#/components/schemas/Pagination'
            multipart/form-data:
              schema:
                type: object
                properties: {}
            text/html:
              schema:
                type: object
                properties: {}
components:
  schemas:
    Pagination:
      type: object
      properties:
        page:
          type: integer
          description: Número de la página actual.
        pages:
          type: integer
          description: Número total de páginas.
        total:
          type: integer
          description: Cantidad total de elementos.
        hasPrevPage:
          type: boolean
          description: Indica si existe una página previa.
        hasNextPage:
          type: boolean
          description: Indica si existe una página siguiente.
  securitySchemes:
    API Key:
      name: api-key
      type: apiKey
      in: header
      description: >-
        Todas las llamadas al API tienen que contener este header junto a la
        clave para poder autenticar y autorizar al cliente.

````