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

# List product configurations

> Retrieve a paginated list of product configurations for the specified organization. Returns an array of product configuration objects containing configuration details, including environment, status, product information, and region. Supports pagination, sorting, and filtering via a JSON filter string.



## OpenAPI

````yaml /en/api-reference/openapi.en-v1.json get /v1/organizations/{organization_id}/product-configs
openapi: 3.0.3
info:
  title: Public Portal API
  version: 1.0.0
  description: Public REST API for portal
servers:
  - url: https://api.staging.flxwvdexternal.com
    description: Staging API server.
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/product-configs:
    get:
      tags:
        - Product configurations
      summary: List product configurations
      description: >-
        Retrieve a paginated list of product configurations for the specified
        organization. Returns an array of product configuration objects
        containing configuration details, including environment, status, product
        information, and region. Supports pagination, sorting, and filtering via
        a JSON filter string.
      operationId: list product configs
      parameters:
        - name: organization id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: The unique identifier of the organization
          example: 507f1f77bcf86cd799439011
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: 'Page number (default: 1)'
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            maximum: 100
            minimum: 1
          description: 'Items per page (default: 100, max: 100)'
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: >-
            Sorting field with optional suffix order (:asc or :desc). Use
            response property names. Valid fields: id, environment, created_at,
            active, product_id, region. Example: "product_id:asc" or
            "created_at:desc"
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: >-
            Comma-separated list of fields to include in each product
            configuration item. Selectable fields: id, environment, created_at,
            active, product_id, region. The field id is always included.
          example: environment, active, region
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: >-
            Filter product configurations by one or more criteria. Provide a
            JSON object with filter conditions. You can filter by any field
            returned in the response. Use comparison operators (eq, ne, gt, gte,
            lt, lte, in, nin, contains, startsWith, endsWith, between) and
            combine multiple conditions with logical operators (and, or).
            Maximum length: 5120 characters.
          examples:
            simple:
              summary: Filter by environment
              description: Returns product configurations for a single environment.
              value: '{"field": "environment", "op": "eq", "value": "PRODUCTION"}'
            complex-and:
              summary: Filter by status and region
              description: Returns active product configurations in a specific region.
              value: >-
                {"and": [{"field": "active", "op": "eq", "value": true},
                {"field": "region", "op": "eq", "value": "us-east"}]}
            complex-or-and:
              summary: Combine OR and AND conditions
              description: Match multiple environments and restrict by product.
              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: Paginated list of product configurations successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductConfigV1ListResponseV1'
              examples:
                single-config:
                  summary: Single product configuration
                  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: Multiple product configurations
                  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: Empty list when no configurations exist
                  value:
                    has_next: false
                    data: []
        '400':
          $ref: '#/components/responses/BadRequest'
          description: Invalid request. Invalid pagination, sorting, or filters.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: >-
            Unauthorized: user does not have access to the organization or the
            organization does not exist
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ProductConfigV1ListResponseV1:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indicates if there are more pages available
        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: Unique identifier of the product configuration
          example: 507f1f77bcf86cd799439011
        environment:
          type: string
          description: >-
            Environment type for product configuration (e.g., PRODUCTION,
            STAGING, DEVELOPMENT).
          example: PRODUCTION
        created_at:
          type: string
          format: date-time
          description: >-
            Creation date and time of product configuration (date and time ISO
            8601)
          example: '2024-01-15T10:30:00.000Z'
        active:
          type: boolean
          description: Indicates if the product configuration is active.
          example: true
        product_id:
          type: string
          maxLength: 24
          pattern: ^[0-9a-f]{24}$
          description: Unique identifier of the product associated with this configuration
          example: 507f1f77bcf86cd799439001
        region:
          type: string
          nullable: true
          description: >-
            Name of the region where the product configuration is deployed.
            Nullable if no region assigned.
          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: Bad Request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Too Many Requests
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````