> ## Documentation Index > Fetch the complete documentation index at: https://docs.cognee.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Sessions > Paginated list of sessions. ## Request Parameters - **range** (Literal): Time window on last_activity_at: 24h, 7d, 30d, or all (default: 30d). - **status** (Optional[str]): Effective-status filter: running, completed, failed, or abandoned. - **limit** (int): Page size, 1-500 (default: 50). - **offset** (int): Rows to skip for pagination (default: 0). - **order_by** (str): Sort column: last_activity_at, started_at, ended_at, cost_usd, tokens_in, or tokens_out (default: last_activity_at). - **descending** (bool): Sort newest/largest first (default: true). Response envelope:: { "sessions": [...], "total": , # rows matching filters before pagination "limit": , "offset": , "has_more": , } ## OpenAPI ````yaml /cognee_openapi_spec.json get /api/v1/sessions openapi: 3.1.0 info: title: Cognee API description: Cognee API with Bearer token and Cookie auth version: 1.0.0 servers: - url: https://api.cognee.ai description: Production server (full functionality) - url: http://localhost:8000 description: Local development server (requires local setup) security: - BearerAuth: [] - ApiKeyAuth: [] tags: - name: activity description: '' - name: add description: Data ingestion endpoints for adding text, files, and structured data. - name: agent connections description: '' - name: agent management description: '' - name: auth description: >- Authentication endpoints for user registration, login, and token management. - name: checks description: '' - name: cognify description: >- Knowledge processing endpoints to transform raw data into knowledge graphs. - name: configuration description: '' - name: datasets description: Dataset management endpoints for listing, creating, and deleting datasets. - name: delete description: Data deletion endpoints (deprecated — use datasets endpoints instead). - name: forget description: '' - name: health description: '' - name: improve description: '' - name: integrations description: '' - name: llm description: '' - name: memify description: '' - name: ontologies description: '' - name: permissions description: Permission management for multi-user access control. - name: recall description: '' - name: remember description: '' - name: responses description: Response generation endpoints using the knowledge graph. - name: schema description: '' - name: search description: Search endpoints for querying the knowledge graph. - name: sessions description: '' - name: settings description: Configuration endpoints for managing Cognee settings. - name: skills description: '' - name: slack description: '' - name: sync description: '' - name: update description: '' - name: users description: User management endpoints. - name: visualize description: Graph visualization endpoints. paths: /api/v1/sessions: get: tags: - sessions summary: List Sessions description: >- Paginated list of sessions. ## Request Parameters - **range** (Literal): Time window on last_activity_at: 24h, 7d, 30d, or all (default: 30d). - **status** (Optional[str]): Effective-status filter: running, completed, failed, or abandoned. - **limit** (int): Page size, 1-500 (default: 50). - **offset** (int): Rows to skip for pagination (default: 0). - **order_by** (str): Sort column: last_activity_at, started_at, ended_at, cost_usd, tokens_in, or tokens_out (default: last_activity_at). - **descending** (bool): Sort newest/largest first (default: true). Response envelope:: { "sessions": [...], "total": , # rows matching filters before pagination "limit": , "offset": , "has_more": , } operationId: list_sessions_api_v1_sessions_get parameters: - name: range in: query required: false schema: enum: - 24h - 7d - 30d - all type: string description: >- Time window filtered on last_activity_at: last 24 hours (24h), 7 days (7d), 30 days (30d), or all time (all). examples: - 30d default: 30d title: Range description: >- Time window filtered on last_activity_at: last 24 hours (24h), 7 days (7d), 30 days (30d), or all time (all). - name: status in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by effective status: 'running', 'completed', 'failed', or 'abandoned'. 'abandoned' is computed at read time: stored status 'running' with last_activity_at older than SESSION_ABANDON_AFTER_SECONDS (default 30 min). Any other value matches nothing and returns an empty list. examples: - completed title: Status description: >- Filter by effective status: 'running', 'completed', 'failed', or 'abandoned'. 'abandoned' is computed at read time: stored status 'running' with last_activity_at older than SESSION_ABANDON_AFTER_SECONDS (default 30 min). Any other value matches nothing and returns an empty list. - name: limit in: query required: false schema: type: integer maximum: 500 minimum: 1 description: Page size (max 500). default: 50 title: Limit description: Page size (max 500). - name: offset in: query required: false schema: type: integer minimum: 0 description: Rows to skip for pagination. default: 0 title: Offset description: Rows to skip for pagination. - name: order_by in: query required: false schema: type: string description: >- Column to sort by: last_activity_at, started_at, ended_at, cost_usd, tokens_in, or tokens_out. Unknown values silently fall back to last_activity_at. examples: - cost_usd default: last_activity_at title: Order By description: >- Column to sort by: last_activity_at, started_at, ended_at, cost_usd, tokens_in, or tokens_out. Unknown values silently fall back to last_activity_at. - name: descending in: query required: false schema: type: boolean description: Sort descending (newest/largest first). default: true title: Descending description: Sort descending (newest/largest first). responses: '200': description: Successful Response content: application/json: schema: {} '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - BearerAuth: [] - ApiKeyAuth: [] components: schemas: HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT ApiKeyAuth: type: apiKey in: header name: X-Api-Key ````