---
title: "List"
method: GET
path: "/tracking/sessions/list/v1"
tags: ["/tracking"]
---

# List

`GET /tracking/sessions/list/v1`

Lists sessions with filtering, sorting, and pagination. Use org_scope to restrict to owned, shared, or both (default). | auth: api_key | authz: min_org_role=operator | () -> (SessionListRes)

## Query parameters

- `sort_by` 'created_at_timestamp' | 'last_seen_at_timestamp' | 'termination_scheduled_for_timestamp' | 'terminated_at_timestamp'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer
- `search` string, nullable — Full-text search query
- `org_scope` 'owned' | 'shared' | 'owned_and_shared'
- `filter_terminated` boolean, nullable — Filter by terminated status
- `filter_public` boolean, nullable — Filter by public visibility
- `filter_device_id` string, nullable — Filter by device ID
- `filter_off_chrt_reference_id` string, nullable — Must be a URL-safe string of 1-64 characters. Allowed characters: A-Z, a-z, 0-9, '.', '_', '~', '-' (RFC 3986 unreserved).
- `filter_flight_number` string, nullable — Filter by flight number (exact match)
- `filter_flight_loaded_status` string, nullable — Filter by flight loaded status (exact match)
- `filter_has_last_seen` boolean, nullable — Filter by whether both last_seen_at_location and last_seen_at_timestamp are set
- `filter_created_at_timestamp_gte` string, date-time, nullable — Filter by created_at_timestamp >= value
- `filter_created_at_timestamp_lte` string, date-time, nullable — Filter by created_at_timestamp <= value
- `filter_last_seen_at_timestamp_gte` string, date-time, nullable — Filter by last_seen_at_timestamp >= value
- `filter_last_seen_at_timestamp_lte` string, date-time, nullable — Filter by last_seen_at_timestamp <= value
- `filter_termination_scheduled_for_timestamp_gte` string, date-time, nullable — Filter by termination_scheduled_for_timestamp >= value
- `filter_termination_scheduled_for_timestamp_lte` string, date-time, nullable — Filter by termination_scheduled_for_timestamp <= value
- `filter_terminated_at_timestamp_gte` string, date-time, nullable — Filter by terminated_at_timestamp >= value
- `filter_terminated_at_timestamp_lte` string, date-time, nullable — Filter by terminated_at_timestamp <= value

## Response `200`

Successful Response

- SessionListRes
  - `items` Session2[], required — unresolved $ref
  - `total_count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)