---
title: "List all active sessions"
method: GET
path: "/api/messaging/sessions"
tags: ["messaging"]
---

# List all active sessions

`GET /api/messaging/sessions`

Administrative endpoint to list all active sessions in the system

## Response `200`

Sessions list retrieved successfully

- object
  - `sessions` SessionInfo[]
    - `sessionId` string — Unique session identifier
    - `agentId` string, uuid — UUID of the agent
    - `userId` string, uuid — UUID of the user
    - `createdAt` string, date-time — Session creation timestamp
    - `lastActivity` string, date-time — Last activity timestamp
    - `metadata` object — Session metadata
    - `expiresAt` string, date-time — When the session will expire
    - `timeoutConfig` object — Current timeout configuration
      - `timeoutMinutes` integer — Inactivity timeout in minutes
      - `autoRenew` boolean — Whether auto-renewal is enabled
      - `maxDurationMinutes` integer — Maximum total session duration
      - `warningThresholdMinutes` integer — Minutes before expiration to trigger warning
    - `renewalCount` integer — Number of times the session has been renewed
    - `timeRemaining` integer — Milliseconds until session expiration
    - `isNearExpiration` boolean — Whether the session is within the warning threshold
  - `total` integer — Total number of active sessions
  - `stats` object
    - `totalSessions` integer
    - `activeSessions` integer
    - `expiredSessions` integer

---

[API](https://skmtc.net/elizaos/apis/eliza-os-api.md) · [All operations](https://skmtc.net/elizaos/apis/eliza-os-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/elizaos/eliza-os-api/versions/f43280bfdb0c/schema)