> ## 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 aplicativos instalados > Devolve uma lista paginada de aplicativos instalados disponíveis no alcance da organização. ## OpenAPI ````yaml /pt-BR/api-reference/openapi.pt-v1.json get /v1/organizations/{organization_id}/installed-apps 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}/installed-apps: get: tags: - Aplicações instaladas summary: Listar aplicativos instalados description: >- Devolve uma lista paginada de aplicativos instalados disponíveis no alcance da organização. operationId: get_installed_apps 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. example: 507f1f77bcf86cd799439011 - 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: Número de elementos por página. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Nomes de campos do elemento de resposta separados por vírgulas que serão incluídos. - name: filters in: query required: false schema: type: string maxLength: 5120 description: Expressão de filtro JSON sobre os campos de filtro suportados. examples: simple: summary: Filtrar por nome de aplicativo value: '{"field":"name","op":"contains","value":"chrome"}' complex-and: summary: Filtrar por sistema operacional e presença de instalação value: >- {"and":[{"field":"operating_system","op":"eq","value":"Windows"},{"field":"has_installations","op":"eq","value":true}]} complex-or-and: summary: Combinar alternativas de editor com presença de instalação value: >- {"and":[{"or":[{"field":"publisher","op":"contains","value":"microsoft"},{"field":"publisher","op":"contains","value":"google"}]},{"field":"has_installations","op":"eq","value":true}]} - name: aggregate in: query required: false schema: type: string maxLength: 1024 description: >- Expressão de agregação JSON com `group_by` e `aggregates`. Não pode ser combinada com `fields`. examples: group_by_operating_system: summary: Agrupar por sistema operacional e contar value: >- {"group_by":["operating_system"],"aggregates":[{"field":"*","function":"count"}]} group_by_publisher_avg_installations: summary: Agrupar por editor e calcular média de instalações value: >- {"group_by":["publisher"],"aggregates":[{"field":"*","function":"count"},{"field":"installations","function":"avg"}]} - name: sort in: query required: false schema: type: string pattern: ^([a-z_]+):(asc|desc)$ description: >- Expressão de ordenação no formato :asc|desc. No modo agregado, só aceita campos de `group_by` ou aliases agregados (`count`, `_`). responses: '200': description: Aplicativos instalados recuperados corretamente. content: application/json: schema: $ref: '#/components/schemas/GetInstalledAppsResponseV1' examples: paginated_result: summary: Lista paginada com aplicativos instalados value: has_next: true data: - id: 64f0c2a1b2d3e4f5060708c1 organization_id: 507f1f77bcf86cd799439011 name: Microsoft Edge discovered_at: '2026-03-10T09:00:00Z' reported_at: '2026-03-15T09:45:11Z' operating_system: windows publisher: Microsoft Corporation installations: 4 empty_result: summary: Não se encontraram aplicativos instalados value: has_next: false data: [] '400': description: Parâmetros de solicitação inválidos. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Formato de filtros inválido value: error: message: Formato de filtros no válido code: bad_request details: filters debe ser un JSON válido '401': description: Não autorizado ou a organização não é acessível. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Falha de acesso à organização value: error: message: No autorizado code: unauthorized '404': description: >- O recurso solicitado não foi encontrado no âmbito autorizado da organização. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: resource_not_found: summary: Não se encontrou o recurso solicitado 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: Falha não controlada value: error: message: Error interno del servidor code: internal_error components: schemas: GetInstalledAppsResponseV1: type: object properties: has_next: type: boolean description: Indica se há outra página disponível. data: type: array items: $ref: '#/components/schemas/GetInstalledAppsItemV1' 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 GetInstalledAppsItemV1: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador do aplicativo instalado. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Identificador da organização associado a este item de aplicativo instalado. name: type: string description: Nome do aplicativo instalado. discovered_at: type: string format: date-time nullable: true description: Marca de tempo da primeira descoberta. reported_at: type: string format: date-time description: Marca de tempo do último relatório. operating_system: type: string enum: - windows - linux - android - mac_os - chrome_os - other description: Sistema operacional onde o aplicativo é observado. publisher: type: string nullable: true description: Publicador do aplicativo. installations: type: integer minimum: 0 description: Número de instalações observadas para o aplicativo. required: - id - organization_id - name - reported_at - operating_system - installations securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````