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

# List

`GET /tracking/devices/list/v1`

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

## Query parameters

- `sort_by` 'registered_at_timestamp' | 'last_seen_at_timestamp' | 'first_seen_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_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_type` 'D15N-tag' | 'MTB06-label' | 'T3-D-tag'
- `filter_active_cargo_id` string, nullable — Filter by active cargo ID
- `filter_active_session_id` string, nullable — Filter by active session ID
- `filter_has_active_session` boolean, nullable — Filter by whether device has an active session (true = session_id is not null, false = session_id is null)
- `filter_has_active_cargo` boolean, nullable — Filter by whether device has an active cargo (true = cargo_id is not null, false = cargo_id is null)
- `filter_registered_at_timestamp_gte` string, date-time, nullable — Filter by registered_at_timestamp >= value
- `filter_registered_at_timestamp_lte` string, date-time, nullable — Filter by registered_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_first_seen_at_timestamp_gte` string, date-time, nullable — Filter by first_seen_at_timestamp >= value
- `filter_first_seen_at_timestamp_lte` string, date-time, nullable — Filter by first_seen_at_timestamp <= value
- `filter_archived` boolean, nullable — Filter by archived status

## Response `200`

Successful Response

- DeviceListRes
  - `items` DeviceLimitedForList1[], 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)