> ## 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 sesiones > Devuelve una lista paginada de sesiones de la organización. ## OpenAPI ````yaml /api-reference/openapi-v1.json get /v1/organizations/{organization_id}/sessions openapi: 3.0.3 info: title: API Publica Portal version: 1.0.0 description: Api publica REST para portal servers: - url: https://api.staging.flxwvdexternal.com description: Staging API server security: - bearerAuth: [] tags: [] paths: /v1/organizations/{organization_id}/sessions: get: tags: - Sesiones summary: Listar sesiones description: Devuelve una lista paginada de sesiones de la organización. operationId: get_sessions parameters: - name: organization_id in: path required: true schema: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización. example: 507f1f77bcf86cd799439011 - 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 de elementos por página. - name: fields in: query required: false schema: type: string maxLength: 2048 description: Nombres de campos de elementos de respuesta separados por comas. - name: filters in: query required: false schema: type: string maxLength: 5120 description: >- Expresión de filtro JSON sobre rutas de campos de respuesta filtrables. examples: simple: summary: Filtrar por nombre de usuario value: '{"field":"user_name","op":"contains","value":"jdoe"}' complex-and: summary: Filtrar por estado y estado de conexión value: >- {"and":[{"field":"session_status","op":"eq","value":"active"},{"field":"connection_state","op":"eq","value":"active"}]} complex-or-and: summary: Combinar condiciones OR y AND value: >- {"and":[{"or":[{"field":"connection_state","op":"eq","value":"active"},{"field":"connection_state","op":"eq","value":"disconnected"}]},{"field":"current_dc_name","op":"contains","value":"dc-eu"}]} - name: sort in: query required: false schema: type: string pattern: ^([a-z_]+):(asc|desc)$ description: >- Expresión de ordenación con el formato :asc|desc. En modo agregado, solo acepta campos de `group_by` o aliases agregados (`count`, `_`). - name: aggregate in: query required: false schema: type: string maxLength: 1024 description: >- Expresión JSON para agregación. Estructura: {"group_by":["field"],"aggregates":[{"field":"*","function":"count"}]}. No se puede combinar con `fields`. examples: group-by-connection-state-count: summary: Agrupar por estado de conexión y contar value: >- {"group_by":["connection_state"],"aggregates":[{"field":"*","function":"count"}]} group-by-platform-avg-cpu: summary: Agrupar por plataforma y calcular promedio value: >- {"group_by":["platform_type"],"aggregates":[{"field":"*","function":"count"},{"field":"cpu_usage","function":"avg"}]} responses: '200': description: Sesiones recuperadas correctamente. content: application/json: schema: $ref: '#/components/schemas/GetSessionsResponseV1' examples: paginated_result: summary: Lista paginada con sesiones value: has_next: true data: - id: 550E8400-E29B-41D4-A716-446655440000 user_name: contoso\jdoe session_type: vdi_desktop windows_session_id: 7 connection_state: active start_date: '2026-03-15T08:30:00Z' cpu_usage: 34.2 ram_usage_gb: 3.8 rtt_usage: 18.1 session_status: active platform_type: windows connected: true current_session_id: 41 current_dc_name: dc-eu-01 current_uid_usage: 2.4 flexx_analyzer_executed: false last_connection_time: '2026-03-15T09:45:11Z' log_on_duration: 35 number_alerts_user: 0 number_alerts_vm: 1 ram_usage: 3891 ram_percentage: 47 session_key: 6BA7B810-9DAD-11D1-80B4-00C04FD430C8 workspace_id: 64f0c2a1b2d3e4f5060708aa organization_id: 507f1f77bcf86cd799439011 empty_result: summary: No se encontraron sesiones value: has_next: false data: [] aggregated_by_connection_state: summary: Resultado agregado por estado de conexión value: has_next: false data: - connection_state: active count: 120 avg_cpu_usage: 17.4 - connection_state: disconnected count: 45 avg_cpu_usage: 3.1 '400': description: Parámetros de solicitud 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 inválido code: bad_request details: filters debe ser una cadena JSON válida '401': description: No autorizado o la organización no es accesible. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: organization_not_authorized: summary: Fallo de acceso a la organización value: error: message: No autorizado code: unauthorized '404': description: >- No se encontró el recurso solicitado dentro del alcance autorizado de la organización. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: resource_not_found: summary: No se encontró el recurso solicitado value: error: message: No encontrado code: not_found '500': description: Error interno del servidor. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: unexpected_error: summary: Fallo no controlado value: error: message: Error interno del servidor code: internal_error components: schemas: GetSessionsResponseV1: type: object properties: has_next: type: boolean description: Si hay otra página disponible. data: type: array items: $ref: '#/components/schemas/GetSessionItemV1' 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 GetSessionItemV1: type: object properties: id: type: string format: uuid pattern: ^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$ minLength: 36 maxLength: 36 description: Identificador de la sesión. user_name: type: string description: Cuenta de usuario de la sesión. session_type: type: string enum: - vdi_desktop - application - sdi_desktop - device description: Tipo de sesión. windows_session_id: type: integer description: Identificador de sesión de Windows. connection_state: type: string enum: - unknown - connected - disconnected - terminated - preparing_session - active - reconnecting - non_broker_session - other - pending description: Estado de conexión de la sesión. start_date: type: string description: Marca de tiempo de inicio de la sesión. cpu_usage: type: number nullable: true description: Uso actual de CPU. ram_usage_gb: type: number nullable: true description: Uso actual de RAM en gigabytes. rtt_usage: type: number nullable: true description: Uso actual de RTT. session_status: type: string description: Estado de la sesión. platform_type: type: string enum: - windows - mac - linux - android - chrome_os - unknown description: Tipo de plataforma. connected: type: boolean description: Indicador de conexión actual. current_session_id: type: integer description: Identificador de sesión de conexión actual. current_dc_name: type: string description: Nombre actual del centro de datos. current_uid_usage: type: number nullable: true description: Uso actual de UID. flexx_analyzer_executed: type: boolean description: Si la ejecución del analizador ha finalizado. last_connection_time: type: string description: Cadena de marca de tiempo de la última conexión. log_on_duration: type: number description: Duración de inicio de sesión. number_alerts_user: type: number nullable: true description: Número de alertas de usuario. number_alerts_vm: type: number nullable: true description: Número de alertas de Workspace. ram_usage: type: number nullable: true description: Uso actual de RAM. ram_percentage: type: number nullable: true description: Porcentaje actual de uso de RAM. session_key: type: string format: uuid pattern: ^[0-9A-F]{8}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{4}-[0-9A-F]{12}$ minLength: 36 maxLength: 36 description: Clave de sesión. workspace_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: >- Identificador MongoDB (_id) del Workspace asociado con la sesión, resuelto a partir de la relación de sesión. organization_id: type: string pattern: ^[0-9a-f]{24}$ minLength: 24 maxLength: 24 description: Identificador de la organización asociado con la sesión. required: - id - user_name - session_type - windows_session_id - connection_state - start_date - cpu_usage - ram_usage_gb - rtt_usage - session_status - platform_type - connected - current_session_id - current_dc_name - current_uid_usage - flexx_analyzer_executed - last_connection_time - log_on_duration - number_alerts_user - number_alerts_vm - ram_usage - ram_percentage - session_key - workspace_id - organization_id securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````