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

# Llistar configuracions de producte

> Recupera una llista paginada de configuracions de producte per a l'organització especificada. Torna un arranjament d'objectes de configuració de producte que conté detalls de configuració, inclosos entorn, estat, informació del producte i regió. Admet paginació, ordenament i filtrat mitjançant una cadena de filtre JSON.



## OpenAPI

````yaml /ca/api-reference/openapi.ca-v1.json get /v1/organizations/{organization_id}/product-configs
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 1.0.0
  description: API pública REST per al portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/product-configs:
    get:
      tags:
        - Configuracions de producte
      summary: Llistar configuracions de producte
      description: >-
        Recupera una llista paginada de configuracions de producte per a
        l'organització especificada. Torna un arranjament d'objectes de
        configuració de producte que conté detalls de configuració, inclosos
        entorn, estat, informació del producte i regió. Admet paginació,
        ordenament i filtrat mitjançant una cadena de filtre JSON.
      operationId: listProductConfigs
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: El identificador únic de l'organització
          example: 507f1f77bcf86cd799439011
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: 'Número de pàgina (predeterminat: 1)'
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            maximum: 100
            minimum: 1
          description: 'Elements per pàgina (predeterminat: 100, màxim: 100)'
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: >-
            Camp de ordenació amb sufix d'ordre opcional (:asc o :desc). Usa els
            noms de propietats de la resposta. Camps vàlids: id, environment,
            created_at, active, product_id, region. Exemple: "product_id:asc" o
            "created_at:desc"
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: >-
            Llista separada per comes de camps per incloure en cada element de
            configuració de producte. Camps seleccionables: id, environment,
            created_at, active, product_id, region. El camp id sempre s'inclou.
          example: environment,active,region
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: >-
            Filtra configuracions de producte per un o més criteris. Proporciona
            un objecte JSON amb condicions de filtre. Pots filtrar per qualsevol
            camp retornat en la resposta. Usa operadors de comparació (eq, ne,
            gt, gte, lt, lte, in, nin, contains, startsWith, endsWith, between)
            i combina múltiples condicions amb operadors lògics (and, or).
            Longitud màxima: 5120 caràcters.
          examples:
            simple:
              summary: Filtrar per entorn
              description: Retorna configuracions de producte per a un únic entorn.
              value: '{"field": "environment", "op": "eq", "value": "PRODUCTION"}'
            complex-and:
              summary: Filtrar per estat i regió
              description: >-
                Retorna configuracions de producte actives en una regió
                específica.
              value: >-
                {"and": [{"field": "active", "op": "eq", "value": true},
                {"field": "region", "op": "eq", "value": "us-east"}]}
            complex-or-and:
              summary: Combina condicions OR i AND
              description: Coincideix amb múltiples entorns i restringeix per producte.
              value: >-
                {"and": [{"or": [{"field": "environment", "op": "eq", "value":
                "PRODUCTION"}, {"field": "environment", "op": "eq", "value":
                "STAGING"}]}, {"field": "product_id", "op": "eq", "value":
                "507f1f77bcf86cd799439001"}]}
      responses:
        '200':
          description: >-
            Llista paginada de configuracions de producte recuperada
            correctament.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductConfigV1ListResponseV1'
              examples:
                single-config:
                  summary: Configuració de producte única
                  value:
                    has_next: false
                    data:
                      - id: 507f1f77bcf86cd799439011
                        environment: PRODUCTION
                        created_at: '2024-01-15T10:30:00.000Z'
                        active: true
                        product_id: 507f1f77bcf86cd799439001
                        region: us-east
                multiple-configs:
                  summary: Múltiples configuracions de producte
                  value:
                    has_next: true
                    data:
                      - id: 507f1f77bcf86cd799439011
                        environment: PRODUCTION
                        created_at: '2024-01-15T10:30:00.000Z'
                        active: true
                        product_id: 507f1f77bcf86cd799439001
                        region: us-east
                      - id: 507f1f77bcf86cd799439012
                        environment: STAGING
                        created_at: '2024-01-20T14:45:00.000Z'
                        active: false
                        product_id: 507f1f77bcf86cd799439001
                        region: null
                empty-list:
                  summary: Llista buida quan no existeixen configuracions
                  value:
                    has_next: false
                    data: []
        '400':
          $ref: '#/components/responses/BadRequest'
          description: Sol·licitud incorrecta. Paginació, ordenament o filtres invàlids.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: >-
            No autoritzat: l'usuari no té accés a l'organització o
            l'organització no existeix
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ProductConfigV1ListResponseV1:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indica si hi ha més pàgines disponibles
        data:
          type: array
          items:
            $ref: '#/components/schemas/ProductConfigV1'
      required:
        - has_next
        - data
    ProductConfigV1:
      type: object
      properties:
        id:
          type: string
          maxLength: 24
          pattern: ^[0-9a-f]{24}$
          description: Identificador únic de la configuració de producte
          example: 507f1f77bcf86cd799439011
        environment:
          type: string
          description: >-
            Tipus d'entorn per a la configuració de producte (p. ex.,
            PRODUCTION, STAGING, DEVELOPMENT)
          example: PRODUCTION
        created_at:
          type: string
          format: date-time
          description: >-
            Data i hora de creació de la configuració de producte (data i hora
            ISO 8601)
          example: '2024-01-15T10:30:00.000Z'
        active:
          type: boolean
          description: Indica si la configuració de producte està activa.
          example: true
        product_id:
          type: string
          maxLength: 24
          pattern: ^[0-9a-f]{24}$
          description: Identificador únic del producte associat amb aquesta configuració
          example: 507f1f77bcf86cd799439001
        region:
          type: string
          nullable: true
          description: >-
            Nom de la regió on es desplega la configuració de producte. Nul si
            no hi ha regió assignada.
          example: us-east
      required:
        - id
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
  responses:
    BadRequest:
      description: Sol·licitud incorrecta
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: No autoritzat
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Masses sol·licituds
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Error intern del servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````