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

# Listar configurações de produto

> Recupera uma lista paginada de configurações de produto para a organização especificada. Retorna um conjunto de objetos de configuração de produto que contém detalhes de configuração, incluindo ambiente, estado, informação do produto e região. Suporta paginação, ordenação e filtração mediante uma cadeia de filtros JSON.



## OpenAPI

````yaml /pt-BR/api-reference/openapi.pt-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 para portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags: []
paths:
  /v1/organizations/{organization_id}/product-configs:
    get:
      tags:
        - Configurações de produto
      summary: Listar configurações de produto
      description: >-
        Recupera uma lista paginada de configurações de produto para a
        organização especificada. Retorna um conjunto de objetos de configuração
        de produto que contém detalhes de configuração, incluindo ambiente,
        estado, informação do produto e região. Suporta paginação, ordenação e
        filtração mediante uma cadeia de filtros JSON.
      operationId: listProductConfigs
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            maxLength: 24
            pattern: ^[0-9a-f]{24}$
          description: O identificador único da organização
          example: 507f1f77bcf86cd799439011
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: 'Número da página (padrão: 1)'
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            maximum: 100
            minimum: 1
          description: 'Itens por página (padrão: 100, máximo: 100)'
        - name: sort
          in: query
          required: false
          schema:
            type: string
          description: >-
            Campo de ordenação com sufixo de ordem opcional (:asc ou :desc)
            Utilize os nomes de propriedades da resposta Campos válidos: id,
            environment, created_at, active, product_id, region Exemplo:
            "product_id:asc" ou "created_at:desc"
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: >-
            Lista separada por vírgulas dos campos para incluir em cada item de
            configuração de produto. Campos selecionáveis: id, environment,
            created_at, active, product_id, region. O campo id sempre é
            incluído.
          example: environment,active,region
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: >-
            Filtra configurações de produto por um ou mais critérios. Fornece um
            objeto JSON com condições de filtro. Pode filtrar por qualquer campo
            retornado na resposta. Usa operadores de comparação (eq, ne, gt,
            gte, lt, lte, in, nin, contains, startsWith, endsWith, between) e
            combina múltiplas condições com operadores lógicos (and, or).
            Tamanho máximo: 5120 caracteres.
          examples:
            simple:
              summary: Filtrar por ambiente
              description: Retorna configurações de produto para um único ambiente.
              value: '{"field": "environment", "op": "eq", "value": "PRODUCTION"}'
            complex-and:
              summary: Filtrar por estado e região
              description: >-
                Retorna configurações de produto ativas em uma região
                específica.
              value: >-
                {"and": [{"field": "active", "op": "eq", "value": true},
                {"field": "region", "op": "eq", "value": "us-east"}]}
            complex-or-and:
              summary: Combinar condições OU e E
              description: Coincidir com múltiplos ambientes e restringir por produto.
              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: Lista paginada de configurações de produto recuperada corretamente.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProductConfigV1ListResponseV1'
              examples:
                single-config:
                  summary: Configuração de produto ú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últiplas configurações de produto
                  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: Lista vazia quando não existem configurações
                  value:
                    has_next: false
                    data: []
        '400':
          $ref: '#/components/responses/BadRequest'
          description: Requisição incorreta. Paginação, ordenação ou filtros inválidos.
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: >-
            Não autorizado: o usuário não tem acesso à organização ou a
            organização não existe
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    ProductConfigV1ListResponseV1:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indica se há mais páginas disponíveis
        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 único da configuração de produto
          example: 507f1f77bcf86cd799439011
        environment:
          type: string
          description: >-
            Tipo de ambiente para a configuração de produto (por exemplo,
            PRODUCTION, STAGING, DEVELOPMENT)
          example: PRODUCTION
        created_at:
          type: string
          format: date-time
          description: >-
            Data e hora de criação da configuração de produto (data e hora ISO
            8601)
          example: '2024-01-15T10:30:00.000Z'
        active:
          type: boolean
          description: Indica se a configuração de produto está ativa.
          example: true
        product_id:
          type: string
          maxLength: 24
          pattern: ^[0-9a-f]{24}$
          description: Identificador único do produto associado a essa configuração
          example: 507f1f77bcf86cd799439001
        region:
          type: string
          nullable: true
          description: >-
            Nome da região onde a configuração de produto é implantada. Nulo se
            não houver região atribuída.
          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: Solicitação incorreta
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    Unauthorized:
      description: Não autorizado
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    TooManyRequests:
      description: Solicitações em excesso
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    InternalServerError:
      description: Erro interno do servidor
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````