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

# List organization microservices

> Returns a paginated list of microservices visible to the target organization (own or delegated according to caller's permissions), enriched with its enablement status and associated configuration when present. Enablement resolution is strictly performed with the organization_id sent in the path.



## OpenAPI

````yaml /en/api-reference/openapi.en-v2.json get /v2/organizations/{organization_id}/microservices
openapi: 3.0.3
info:
  title: API Publica Portal
  version: 2.0.0
  description: Public REST API for portal
servers:
  - url: https://api.flexxible.net
    description: Portal API (production)
security:
  - bearerAuth: []
tags:
  - name: Digital activity
    description: Creation of core process groups by organization
  - name: Roles
    description: Endpoint de creacion de roles de organizacion
  - name: Usuarios
    description: Endpoint de creacion de usuarios de organizacion
  - name: Grupos de workspaces
    description: Endpoints de gestión de grupos de workspaces
  - name: Workspaces
    description: Endpoint de eliminacion de workspaces de la organizacion
  - name: Aplicaciones instaladas
    description: Endpoint de detalle de aplicación instalada de la organización
  - name: Autenticación
    description: Endpoints de autenticación y contexto de sesión
  - name: Microservicios
    description: Detalle de microservicios por organizacion
  - name: Operaciones
    description: Consulta de detalle de operaciones por organización
  - name: Organización
    description: Operaciones de organización
  - name: Objetivos de política de parches
    description: Endpoints de gestión de objetivos de política de parches
  - name: Configuraciones de producto
    description: Endpoints de gestión de configuraciones de producto
  - name: Grupos de reporte
    description: Operaciones sobre grupos de reporte
  - name: Sesiones
    description: Endpoint de detalle de sesion de la organizacion
  - name: Tenants
    description: Endpoints de gestión de tenants
paths:
  /v2/organizations/{organization_id}/microservices:
    get:
      tags:
        - Microservices
      summary: List organization microservices
      description: >-
        Returns a paginated list of microservices visible to the target
        organization (own or delegated according to caller's permissions),
        enriched with its enablement status and associated configuration when
        present. Enablement resolution is strictly performed with the
        organization_id sent in the path.
      operationId: get_microservices
      parameters:
        - name: organization_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: >-
            Identifier of the target organization querying the catalog;
            enablement is verified against this same identifier.
          example: 507f1f77bcf86cd799439011
        - name: Accept-Language
          in: header
          required: false
          schema:
            type: string
            default: es-ES
            maxLength: 10
          description: >-
            Language to resolve the multilingual fields of the response to a
            single value per field.
          example: es-ES
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          description: Page number.
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            default: 100
            minimum: 1
            maximum: 100
          description: Number of items per page.
        - name: fields
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
          description: Response fields to be included, separated by commas.
        - name: filters
          in: query
          required: false
          schema:
            type: string
            maxLength: 5120
          description: JSON expression of filters on filterable resource fields.
          examples:
            simple:
              summary: Simple filter by name
              value: '{"field":"name","op":"contains","value":"backup"}'
            complex-and:
              summary: Combined filter with AND
              value: >-
                {"and":[{"field":"type","op":"eq","value":"standard"},{"field":"context","op":"eq","value":"organization"}]}
            complex-or-and:
              summary: Combined filter with OR and AND
              value: >-
                {"and":[{"or":[{"field":"category","op":"eq","value":"security"},{"field":"category","op":"eq","value":"automation"}]},{"field":"name","op":"contains","value":"agent"}]}
      responses:
        '200':
          description: Microservices successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMicroservicesResponseV2'
              examples:
                resultado_con_datos:
                  summary: List with results
                  value:
                    has_next: false
                    data:
                      - id: 65f0d9f2b3c4d5e6f7080911
                        organization_id: 507f1f77bcf86cd799439011
                        name: Antivirus Scan
                        description: Escaneo programado de antivirus
                        category: security
                        created_at: '2026-05-15T10:00:00Z'
                        archived_at: null
                        type: standard
                        context: organization
                        is_ai_enhanced: false
                        enabled: true
                        enabled_configuration:
                          enabled_at: '2026-05-15T10:30:00Z'
                          efficiency: 95
                          workspace_group_execution: l1
                          individual_execution: l3
                          end_user_execution_workspace_group_ids:
                            - 65f0d9f2b3c4d5e6f7080931
                            - 65f0d9f2b3c4d5e6f7080932
                      - id: 65f0d9f2b3c4d5e6f7080912
                        organization_id: 507f1f77bcf86cd799439011
                        name: Patch Baseline
                        description: Control de parches pendientes
                        category: maintenance
                        created_at: '2026-05-16T12:00:00Z'
                        archived_at: null
                        type: standard
                        context: organization
                        is_ai_enhanced: true
                        enabled: false
                        enabled_configuration: null
        '400':
          description: Invalid request parameters.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                filters_invalido:
                  summary: Invalid filters format
                  value:
                    error:
                      message: Formato de filtros inválido
                      code: bad_request
                      details: El parámetro filters debe ser una cadena JSON válida.
        '401':
          description: Not authorized or without access to the organization.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                organization_not_authorized:
                  summary: Access to organization not authorized
                  value:
                    error:
                      message: No autorizado
                      code: unauthorized
        '404':
          description: >-
            The requested resource was not found within the organization's
            authorized scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                resource_not_found:
                  summary: Resource not found
                  value:
                    error:
                      message: No encontrado
                      code: not_found
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                unexpected_error:
                  summary: Unhandled error
                  value:
                    error:
                      message: Error interno del servidor
                      code: internal_error
components:
  schemas:
    GetMicroservicesResponseV2:
      type: object
      properties:
        has_next:
          type: boolean
          description: Indicates if there's a next page.
        data:
          type: array
          items:
            $ref: '#/components/schemas/MicroserviceItemV2'
      required:
        - has_next
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
    MicroserviceItemV2:
      type: object
      properties:
        id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Microservice identifier.
        organization_id:
          type: string
          pattern: ^[0-9a-f]{24}$
          minLength: 24
          maxLength: 24
          description: Organization identifier associated with the microservice.
        name:
          type: string
          description: Microservice name resolved in the requested language.
        description:
          type: string
          description: Microservice description resolved in the requested language.
        category:
          type: string
          description: Microservice category resolved in the requested language.
        created_at:
          type: string
          format: date-time
          description: Microservice creation date and time.
        archived_at:
          type: string
          format: date-time
          nullable: true
          description: Archived date and time, when applicable.
        type:
          type: string
          enum:
            - standard
            - condition
          nullable: true
          description: Functional type of microservice.
        context:
          type: string
          nullable: true
          description: Microservice visibility context.
        is_ai_enhanced:
          type: boolean
          nullable: true
          description: Indicates if AI capabilities are enhanced for the microservice.
        enabled:
          type: boolean
          description: Indicates if the microservice is enabled for the organization.
        enabled_configuration:
          type: object
          nullable: true
          description: Organization enabled microservice configuration.
          properties:
            enabled_at:
              type: string
              format: date-time
              nullable: true
              description: Date and time the configuration was enabled.
            efficiency:
              type: number
              description: Enabled configuration efficiency value.
            workspace_group_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Execution mode by workspace groups.
            individual_execution:
              type: string
              enum:
                - l1
                - l2
                - l3
              description: Individual execution mode.
            end_user_execution_workspace_group_ids:
              type: array
              items:
                type: string
                pattern: ^[0-9a-f]{24}$
                minLength: 24
                maxLength: 24
              description: Identifiers of workspace groups enabled for end user execution.
          required:
            - enabled_at
            - efficiency
            - workspace_group_execution
            - individual_execution
            - end_user_execution_workspace_group_ids
      required:
        - id
        - organization_id
        - name
        - description
        - category
        - created_at
        - archived_at
        - type
        - context
        - is_ai_enhanced
        - enabled
        - enabled_configuration
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````