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

# List active price lists

> Active (writable) price lists, so an integration can resolve the priceListId required by the price-set payload. Requires the `prices:read` scope.



## OpenAPI

````yaml /desarrolladores/api/openapi.json get /prices/lists
openapi: 3.1.0
info:
  title: Riqra Public API
  version: 1.0.0
  description: Programmatic access to a merchant's commerce data.
servers:
  - url: https://api-v2.riqra.com/public/v1
security: []
paths:
  /prices/lists:
    get:
      tags:
        - Prices
      summary: List active price lists
      description: >-
        Active (writable) price lists, so an integration can resolve the
        priceListId required by the price-set payload. Requires the
        `prices:read` scope.
      responses:
        '200':
          description: Active price lists.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PriceListsResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Missing required scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - BearerAuth: []
components:
  schemas:
    PriceListsResponse:
      type: object
      properties:
        priceLists:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                description: Price list UUID; pass as `priceListId` when setting prices.
              name:
                type: string
                description: Price list display name.
              sourcePriceListId:
                type:
                  - string
                  - 'null'
                description: >-
                  For a derived list, the independent list its prices derive
                  from. `null` on an independent list.
              adjustmentType:
                type: string
                enum:
                  - NONE
                  - PERCENT_UP
                  - PERCENT_DOWN
                description: >-
                  How a derived list adjusts its source prices. Always `NONE` on
                  an independent list.
              adjustmentValue:
                type: string
                example: '10.00'
                description: >-
                  Percentage applied by `adjustmentType`; `0` when there is no
                  adjustment.
            required:
              - id
              - name
              - sourcePriceListId
              - adjustmentType
              - adjustmentValue
      required:
        - priceLists
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
          required:
            - code
            - message
            - requestId
      required:
        - error
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'Public API key presented as `Authorization: Bearer rq_live_…`.'

````