---
title: "Get All Sessions"
method: GET
path: "/sessions"
---

# Get All Sessions

`GET /sessions`

Get all sessions for a user, filtered by organization and optional trigger types.

This ensures users can only see sessions within their organization.

Args:
    authorized_user: Authorized user with roles (for RBAC checks)
    trigger_type: Optional list of trigger types to filter by ('auto', 'manual', etc.)
    session_id: Optional list of session IDs to restrict results to.
    page: Optional page number for pagination (defaults to 1 if limit is provided)
    limit: Optional number of sessions per page (if not provided, returns all sessions)
    pinned: If true, restrict results to sessions the requesting user has pinned.
    query: Optional case-insensitive substring match on session title.
    shared: If true, restrict results to sessions shared with the requesting user
        (view access, excluding sessions they own).

Returns:
    GetAllSessionsResponse with list of sessions and optional pagination metadata

## Query parameters

- `trigger_type` TriggerType[], nullable — Filter by trigger type (e.g. 'auto', 'manual', 'alerts_chat').
- `session_id` string[], nullable — Filter to only these session IDs. Repeat the param for multiple (e.g. ?session_id=<id1>&session_id=<id2>).
- `page` integer, nullable — Page number for pagination
- `limit` integer, nullable — Number of sessions per page
- `pinned` boolean — If true, return only sessions the requesting user has pinned.
- `query` string, nullable — Case-insensitive substring match on session title.
- `shared` boolean — If true, return only sessions shared with the requesting user (view access, excluding sessions they own).

## Response `200`

Successful Response

- GetAllSessionsResponse — Response for get_all_sessions endpoint.
  - `all_sessions` SessionListItem[], required
    - `session_id` string, required
    - `incident_description` string, nullable, required
    - `session_title` string, nullable, required
    - `status` string, required
    - `mode` string, nullable, required
    - `access_level` 'view' | 'owner' | 'edit', required
    - `incident_time` string, nullable, required
    - `incident_timezone` string, nullable, required
    - `services_context` unknown[], required
      - unknown
    - `context_items` unknown[], required
      - unknown
    - `trigger_type` string, nullable, required
    - `parent_session_id` string, nullable
    - `pinned` boolean
    - `created_at` string, nullable
  - `count` integer, nullable — Number of sessions in current page
  - `prev` integer, nullable — Previous page number
  - `next` integer, nullable — Next page number
  - `total` integer, nullable — Total number of matching sessions across all pages

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)