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

# List

`GET /tracking_integrations/tive/devices/list/v1`

Lists Tive devices with filtering, sorting, and pagination. Scoped to the caller's organization. | auth: api_key | authz: min_org_role=operator | () -> (TiveDeviceListRes)

## Query parameters

- `sort_by` 'chrt_created_at_timestamp' | 'chrt_updated_at_timestamp'
- `sort_order` 'asc' | 'desc' — Sort order for query results
- `page` integer
- `page_size` integer
- `filter_tive_account_id` integer, nullable — Filter by Tive account ID
- `filter_tive_device_id` string, nullable — Filter by Tive device ID (exact match)
- `filter_chrt_created_at_timestamp_gte` string, date-time, nullable — Filter by chrt_created_at_timestamp >= value
- `filter_chrt_created_at_timestamp_lte` string, date-time, nullable — Filter by chrt_created_at_timestamp <= value

## Response `200`

Successful Response

- TiveDeviceListRes
  - `items` TiveDevice1[], required
    - `schema_version` 1, required
    - `_id` string, required
    - `org_id` string, required — Must be a string starting with `org_`
    - `tive_account_id` integer, required
    - `tive_account_name` string, required
    - `tive_device_id` string, required
    - `tive_device_name` string, required
    - `tive_current_shipment_id` string, nullable
    - `tive_current_public_shipment_id` string, nullable
    - `chrt_created_at_timestamp` string, date-time, required
    - `chrt_updated_at_timestamp` string, date-time, required
  - `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)