> ## 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. # Llistar workspaces per a una app instal·lada > Retorna una llista paginada d'observacions a nivell de Workspace per l'app instal·lada seleccionada en l'abast de l'organització. ## OpenAPI ````yaml /ca/api-reference/openapi.ca-v1.json get /v1/organizations/{organization_id}/installed-apps/{installed_app_id}/workspaces openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: API pública REST per al portal servers: - url: https://api.flexxible.net description: Portal API (production) security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/installed-apps/{installed_app_id}/workspaces: get: tags: - Aplicacions instal·lades summary: Llistar workspaces per a una app instal·lada description: >- Retorna una llista paginada d'observacions a nivell de Workspace per l'app instal·lada seleccionada en l'abast de l'organització. operationId: get_installed_app_workspaces parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organització. example: 507f1f77bcf86cd799439011 - name: installed_app_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador d'app instal·lada. example: 64f0c2a1b2d3e4f5060709aa - name: page in: query required: false schema: type: integer default: 1 minimum: 1 description: Número de pàgina. - name: per_page in: query required: false schema: type: integer default: 100 maximum: 100 minimum: 1 description: Número d'elements per pàgina. - name: fields in: query required: false schema: type: string maxLength: 2048 description: >- Noms de camps d'elements de resposta separats per comes per incloure. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expressió de filtre JSON sobre rutes de camps de resposta filtrables. examples: simple: summary: Filtrar per workspace_id value: >- {"field":"workspace_id","op":"eq","value":"64f0c2a1b2d3e4f5060708f1"} complex-and: summary: Filtrar per install_location i versió value: >- {"and":[{"field":"install_location","op":"contains","value":"Program Files"},{"field":"version","op":"contains","value":"124"}]} complex-or-and: summary: >- Combinar alternatives de installed_at amb una condició d'organització value: >- {"and":[{"or":[{"field":"installed_at","op":"eq","value":"2025-12-01T08:00:00.000Z"},{"field":"installed_at","op":"eq","value":"2025-11-15T09:30:00.000Z"}]},{"field":"organization_id","op":"eq","value":"507f1f77bcf86cd799439011"}]} - name: sort in: query required: false schema: type: string pattern: >- ^(workspace_id|organization_id|version|reported_at|install_location|installed_at):(asc|desc)$ description: Expressió de ordenament amb el format :asc|desc responses: '200': description: Observacions de Workspace d'app instal·lada obtingudes correctament. content: application/json: schema: $ref: '#/components/schemas/GetInstalledAppWorkspacesResponseV1' examples: paginated_result: summary: Observacions de Workspace paginades value: has_next: true data: - workspace_id: 64f0c2a1b2d3e4f5060708f1 organization_id: 507f1f77bcf86cd799439011 version: 124.0.2478.97 reported_at: '2026-01-15T10:20:30.000Z' install_location: C:\Program Files\ExampleApp installed_at: '2025-12-01T08:00:00.000Z' empty_result: summary: No s'han trobat observacions de Workspace value: has_next: false data: [] '400': description: Paràmetres de solicitud invàlids. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: invalid_filters: summary: Format de filters no vàlid value: error: message: Formato de filters invalido code: bad_request details: filters debe ser una expresion de filtro JSON valida '401': description: No autoritzat o l'organització no és accessible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallada d'accés a l'organització value: error: message: No autorizado code: unauthorized '404': description: >- No s'ha trobat l'app instal·lada dins de l'abast d'organització autoritzada. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: installed_app_not_found: summary: No s'ha trobat l'app instal·lada sol·licitada value: error: message: No se encontro la app instalada code: not_found '500': description: Error intern del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallada inesperada value: error: message: Error interno del servidor code: internal_error components: schemas: GetInstalledAppWorkspacesResponseV1: type: object properties: has_next: type: boolean description: Indica si hi ha una altra pàgina disponible. data: type: array items: $ref: '#/components/schemas/GetInstalledAppWorkspacesItemV1' 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 GetInstalledAppWorkspacesItemV1: type: object properties: workspace_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de Workspace. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organització. version: type: string nullable: true description: Versió de l'aplicació instal·lada reportada per al Workspace. reported_at: type: string format: date-time nullable: true description: Data i hora del darrer report d'instal·lació per al Workspace. install_location: type: string nullable: true description: Ruta d'instal·lació reportada per a l'aplicació en el Workspace. installed_at: type: string format: date-time nullable: true description: Data i hora d'instal·lació reportada per al Workspace. required: - workspace_id - organization_id securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````