---
title: "List telematics"
method: GET
path: "/telematics"
tags: ["telematics"]
---

# List telematics

`GET /telematics`

## Request

- Base URL: `https://app.torgix.ai/v1`
- URL: `https://app.torgix.ai/v1/telematics`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://app.torgix.ai/oauth/authorize`, token URL `https://app.torgix.ai/oauth/token`, scopes: `read`)

Returns a page of telematics. Without `sort`, pages are keyset (pass `next_cursor` back as `cursor`); with `sort`, pages are numbered (`page`, `page_size`, `next_page`). Filter on any field: `?status=active` (exact), or an operator in brackets, `?hours[gte]=500`, `?status[in]=open,active`, `?name[like]=%320%`, `?cleared_at[null]=true` (operators: eq, ne, gt, gte, lt, lte, in, nin, like, nlike, null). Add `?changed_since=` for incremental sync and `?fields=` to project columns. Soft-deleted rows are hidden unless `?include_deleted=true`.

## Query parameters

- `fields` string
- `changed_since` string, date-time
- `cursor` string
- `page_size` integer
- `sort` string
- `page` integer
- `include_deleted` boolean

## Response `200`

A page of telematics.

- object
  - `data` object[]
  - `next_cursor` string, nullable: Keyset mode: pass back as ?cursor= for the next page; null when no more.
  - `page` integer: Sorted mode only.
  - `page_size` integer: Sorted mode only.
  - `next_page` integer, nullable: Sorted mode only.
  - `request_id` string

## Other responses

- `401`: Missing or invalid credentials.
- `403`: API access not enabled for the account, missing scope, or IP not allowlisted.
- `429`: Per-second rate limit exceeded.

---

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