> ## 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 microserviços de uma organização > Retorna uma lista paginada de microserviços visíveis para a organização alvo (própria ou delegada conforme permissões do chamador), enriquecida com o estado de habilitação e sua configuração associada quando existente. A resolução de habilitação é realizada estritamente com o organization_id enviado no caminho. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v1.json get /v1/organizations/{organization_id}/microservices 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}/microservices: get: tags: - Microserviços summary: Listar microserviços de uma organização description: >- Retorna uma lista paginada de microserviços visíveis para a organização alvo (própria ou delegada conforme permissões do chamador), enriquecida com o estado de habilitação e sua configuração associada quando existente. A resolução de habilitação é realizada estritamente com o organization_id enviado no caminho. operationId: get_microservices parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Identificador da organização alvo sobre a qual se consulta o catálogo; a habilitação é verificada contra este mesmo identificador. example: 507f1f77bcf86cd799439011 - name: Accept-Language in: header required: false schema: type: string default: es-ES maxLength: 10 description: >- Idioma para resolver os campos multilíngue da resposta para um único valor por campo. example: es-ES - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: Número da página. - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: Quantidade de elementos por página. - name: fields in: query required: false schema: type: string maxLength: 2048 description: Campos de resposta a serem incluídos, separados por vírgulas. - name: filters in: query required: false schema: type: string maxLength: 5120 description: Expressão JSON de filtros sobre campos filtráveis do recurso. examples: simple: summary: Filtro simples por nome value: '{"field":"name","op":"contains","value":"backup"}' complex-and: summary: Filtro composto com AND value: >- {"and":[{"field":"type","op":"eq","value":"standard"},{"field":"context","op":"eq","value":"organization"}]} complex-or-and: summary: Filtro composto com OR e 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: Microserviços recuperados corretamente. content: application/json: schema: $ref: '#/components/schemas/GetMicroservicesResponseV1' examples: resultado_con_datos: summary: Lista com resultados 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: Parâmetros de solicitação inválidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: filters_invalido: summary: Formato de filtros inválido 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: Não autorizado ou sem acesso à organização. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Acesso não autorizado à organização value: error: message: No autorizado code: unauthorized '404': description: >- Recurso solicitado não encontrado dentro do escopo autorizado da organização. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: resource_not_found: summary: Recurso não encontrado value: error: message: No encontrado code: not_found '500': description: Erro interno do servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Erro não controlado value: error: message: Error interno del servidor code: internal_error components: schemas: GetMicroservicesResponseV1: type: object properties: has_next: type: boolean description: Indica se existe uma próxima página. data: type: array items: $ref: '#/components/schemas/MicroserviceItemV1' 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 MicroserviceItemV1: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador do microserviço. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador da organização associada ao microserviço. name: type: string description: Nome do microserviço resolvido no idioma solicitado. description: type: string description: Descrição do microserviço resolvida no idioma solicitado. category: type: string description: Categoria do microserviço resolvida no idioma solicitado. created_at: type: string format: date-time description: Data e hora de criação do microserviço. archived_at: type: string format: date-time nullable: true description: Data e hora de arquivamento, quando aplicável. type: type: string enum: - standard - condition nullable: true description: Tipo funcional do microserviço. context: type: string nullable: true description: Contexto de visibilidade do microserviço. is_ai_enhanced: type: boolean nullable: true description: Indica se o microserviço tem capacidades de IA habilitadas. enabled: type: boolean description: Indica se o microserviço está habilitado para a organização. enabled_configuration: type: object nullable: true description: Configuração habilitada do microserviço para a organização. properties: enabled_at: type: string format: date-time nullable: true description: Data e hora em que a configuração foi habilitada. efficiency: type: number description: Valor de eficiência da configuração habilitada. workspace_group_execution: type: string enum: - l1 - l2 - l3 description: Modo de execução por grupos de workspace. individual_execution: type: string enum: - l1 - l2 - l3 description: Modo de execução individual. end_user_execution_workspace_group_ids: type: array items: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Identificadores de grupos de workspace habilitados para execução de usuário final. 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 ````