> ## 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 precios

> Lista los precios de una lista de precios.



## OpenAPI

````yaml /api/openapi.json get /price-lists/{priceListId}/prices
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:
  /price-lists/{priceListId}/prices:
    parameters:
      - schema:
          type: integer
        name: priceListId
        in: path
        required: true
        description: '`id` de la lista de precios a la que pertenece el precio'
    get:
      tags:
        - Lista de Precios - Precios
      summary: Listar precios
      description: Lista los precios de una lista de precios.
      operationId: get-price-lists-priceListId-prices
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            default: 10
            maximum: 20
          description: Número de elementos a retornar.
        - name: page
          in: query
          schema:
            type: integer
            default: 1
          description: Número de página a retornar.
        - name: customerIds
          in: query
          schema:
            type: array
          description: Arreglo con los IDs de los clientes a consultar.
        - name: variantIds
          in: query
          schema:
            type: array
          description: Arreglo con los IDs de las variantes a consultar.
      requestBody:
        content: {}
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: integer
                          description: ID del precio.
                        price:
                          type: number
                          minimum: 0
                          description: El precio de venta de la variante.
                        oldPrice:
                          type:
                            - number
                            - 'null'
                          minimum: 0
                          description: >-
                            El precio de lista o precio regular de la variante.

                            Si `oldPrice` tiene valor se mostrará al cliente
                            como una comparación de este y `price` en la
                            variante.
                        ribbonLabel:
                          type:
                            - string
                            - 'null'
                          maxLength: 8
                          description: >-
                            Texto de la etiqueta de este precio.

                            Si `ribbonLabel` tiene valor se mostrará al cliente
                            como una etiqueta resaltante en la variante.
                        isTaxExempt:
                          description: >-
                            Indica si el precio de la variante está extento o no
                            del cálculo de impuestos.
                          type: boolean
                        customerId:
                          type:
                            - integer
                            - 'null'
                          description: El `id` del cliente al que pertenece este precio.
                        variantId:
                          type: integer
                          description: >-
                            El `id` de la variante a la que pertenece este
                            precio.
                      required:
                        - id
                        - price
                        - oldPrice
                        - ribbonLabel
                        - isTaxExempt
                        - customerId
                        - variantId
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - data
                  - pagination
              examples:
                Precio en oferta:
                  value:
                    data:
                      - id: 1093
                        price: 25
                        oldPrice: 27
                        ribbonLabel: oferta
                        isTaxExempt: false
                        customerId: null
                        variantId: 1201
                    pagination:
                      page: 1
                      pages: 2
                      hasPrevPage: false
                      hasNextPage: true
                      total: 2
                Precio regular:
                  value:
                    data:
                      - id: 1671
                        price: 20.5
                        oldPrice: null
                        ribbonLabel: null
                        isTaxExempt: false
                        customerId: null
                        variantId: 1201
                    pagination:
                      page: 1
                      pages: 2
                      hasPrevPage: false
                      hasNextPage: true
                      total: 2
                Precio pactado:
                  value:
                    data:
                      - id: 2812
                        price: 10
                        oldPrice: null
                        ribbonLabel: null
                        isTaxExempt: false
                        customerId: 15167
                        variantId: 1201
                    pagination:
                      page: 1
                      pages: 2
                      hasPrevPage: false
                      hasNextPage: true
                      total: 2
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
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.
    BadRequest:
      title: BadRequest
      type: object
      x-examples: {}
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type:
                  - integer
                  - string
                deprecated: true
                description: Código referencial del error. No usar.
      description: ''
  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.

````