---
title: "List Sessions"
method: GET
path: "/sessions"
tags: ["Sessions"]
---

# List Sessions

`GET /sessions`

Retrieve paginated list of sessions with filtering and sorting options. Supports filtering by session type (agent, team, workflow), component, user, and name. Sessions represent conversation histories and execution contexts.

## Query parameters

- `type` 'agent' | 'team' | 'workflow'
- `component_id` string, nullable — Filter sessions by component ID (agent/team/workflow ID)
- `user_id` string, nullable — Filter sessions by user ID
- `session_name` string, nullable — Filter sessions by name (partial match)
- `limit` integer, nullable — Number of sessions to return per page
- `page` integer, nullable — Page number for pagination
- `sort_by` string, nullable — Field to sort sessions by
- `sort_order` 'asc' | 'desc'
- `db_id` string, nullable — Database ID to query sessions from
- `table` string, nullable — The database table to use

## Response `200`

Sessions retrieved successfully

- PaginatedResponseSessionSchema
  - `data` SessionSchema[], required — List of items for the current page
    - `session_id` string, required — Unique identifier for the session
    - `session_name` string, required — Human-readable name for the session
    - `session_state` object, nullable — Current state data of the session
    - `created_at` string, date-time, nullable — Timestamp when session was created
    - `updated_at` string, date-time, nullable — Timestamp when session was last updated
    - `session_type` string, nullable — Type of session: agent, team, or workflow
    - `user_id` string, nullable — User ID associated with the session
    - `agent_id` string, nullable — Agent ID if this is an agent session
    - `team_id` string, nullable — Team ID if this is a team session
    - `workflow_id` string, nullable — Workflow ID if this is a workflow session
    - `session_summary` object, nullable — Summary of session interactions
    - `metrics` object, nullable — Session metrics
    - `total_tokens` integer, nullable — Total tokens used in this session
    - `metadata` object, nullable — Additional metadata
  - `meta` PaginationInfo, required
    - `page` integer — Current page number (0-indexed)
    - `limit` integer — Number of items per page
    - `total_pages` integer — Total number of pages
    - `total_count` integer — Total count of items
    - `search_time_ms` number — Search execution time in milliseconds

## Other responses

- `400` — Invalid session type or filter parameters
- `401` — Unauthorized
- `404` — Not found
- `422` — Validation error in query parameters
- `500` — Internal Server Error

---

[API](https://skmtc.net/agno/apis/agno-api-reference.md) · [All operations](https://skmtc.net/agno/apis/agno-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/agno/agno-api-reference/versions/5f6149d395d0/schema)