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

# Get All Sessions

`GET /sessions`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/sessions`
- Auth: none declared

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

## Changes

> 66 revisions in range; 9 not diffed.

- **2026-09-29** `c939e4d80cd7`: 5 info
  - added the enum value `chat_channel_join_auto_trigger` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`
  - added the enum value `chat_dm` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`
  - added the enum value `chat_investigate_command` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`
  - added the enum value `chat_mention` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`
  - …1 more
- **2026-09-02** `3025330cc50d`: 1 info
  - added the enum value `alert_event_critical_severity_investigate` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`
- **2026-08-28** `6bbc7dd4088c`: 1 info
  - added the enum value `ensemble_member` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`
- **2026-08-21** `867b6cd9e943`: 2 info
  - added the new optional `query` request parameter `query`
  - added the new optional `query` request parameter `shared`
- **2026-08-20** `e0a48df02b41`: 1 info
  - added the enum value `autoresearch` to the property `anyOf[subschema #1]/items/` of the `query` request parameter `trigger_type`

[Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/sessions/get.md)

---

[API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)