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

# Get microservice by identifier

> Returns a microservice visible to the target organization (designer or marketplace), with enablement status and enabled configuration when present.



## OpenAPI

````yaml /en/api-reference/openapi.en-v1.json get /v1/organizations/{organization_id}/microservices/{microservice_id}
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}/microservices/{microservice_id}:
    get:
      tags:
        - Microservices
      summary: Get microservice by identifier
      description: >-
        Returns a microservice visible to the target organization (designer or
        marketplace), with enablement status and enabled configuration when
        present.
      operationId: get_microservice_by_id
      parameters:
        - name: organization id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identifier of the organization querying the microservice.
          example: 507f1f77bcf86cd799439011
        - name: microservice_id
          in: path
          required: true
          schema:
            type: string
            pattern: ^[0-9a-f]{24}$
            minLength: 24
            maxLength: 24
          description: Identifier of the microservice to be retrieved.
          example: 65f0d9f2b3c4d5e6f7080911
        - name: Accept-Language
          in: header
          required: false
          schema:
            type: string
            default: es-ES
            maxLength: 10
          description: Language to resolve multilingual fields to a single value per field.
          example: es-ES
      responses:
        '200':
          description: Microservice successfully retrieved.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMicroserviceByIdResponseV1'
              examples:
                microservicio_habilitado:
                  summary: Microservice found with enabled configuration
                  value:
                    data:
                      id: 65f0d9f2b3c4d5e6f7080911
                      organization_id: 507f1f77bcf86cd799439011
                      name: Antivirus Scan
                      description: Scheduled antivirus scan
                      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
                microservicio_no_habilitado:
                  summary: Microservice found without enabled configuration
                  value:
                    data:
                      id: 65f0d9f2b3c4d5e6f7080912
                      organization_id: 507f1f77bcf86cd799439011
                      name: Patch Baseline
                      description: Pending patches control
                      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:
                id_invalido:
                  summary: Invalid microservice identifier
                  value:
                    error:
                      message: Invalid microservice_id parameter
                      code: bad_request
        '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: Unauthorized
                      code: unauthorized
        '404':
          description: Microservice not found in the organization's authorized scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                microservice_not_found:
                  summary: Microservice not found
                  value:
                    error:
                      message: Not Found
                      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: Internal Server Error
                      code: internal_error
components:
  schemas:
    GetMicroserviceByIdResponseV1:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/MicroserviceItemV1'
      required:
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
            code:
              type: string
            details:
              type: string
          required:
            - message
            - code
      required:
        - error
    MicroserviceItemV1:
      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

````