Skip to main content
GET
/
v2
/
telematics
/
trailer-statuses
List Trailer Statuses
curl --request GET \
  --url https://api.catenatelematics.com/v2/telematics/trailer-statuses \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "fleet_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "connection_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_id": "<string>",
      "source_data_hash": "<string>",
      "fleet_ref": "<string>",
      "deleted_at": "2023-11-07T05:31:56Z",
      "tsp_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "tsp_slug": "<string>",
      "source_data": {},
      "occurred_at": "2023-11-07T05:31:56Z",
      "execution_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "schedule_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "extras": {},
      "trailer_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_trailer_id": "<string>",
      "power_on": true,
      "battery_voltage": 123,
      "battery_percent": 123,
      "source_control_mode": "<string>",
      "door_open": true,
      "fuel_level": 123,
      "reefer_engine_hours": 123,
      "ambient_temperature": 123,
      "zones": [
        {
          "zone": 123,
          "setpoint_temperature": 123,
          "return_air_temperature": 123,
          "discharge_air_temperature": 123,
          "control_sensor": "<string>",
          "door_open": true,
          "thermal_status": "<string>",
          "cargo_status": "<string>"
        }
      ],
      "remote_probe_statuses": [
        {
          "probe_id": "<string>",
          "temperature": 123,
          "humidity_percent": 123
        }
      ],
      "pre_trip_status": {
        "result": "<string>",
        "initiated_at": "2023-11-07T05:31:56Z",
        "completed_at": "2023-11-07T05:31:56Z"
      },
      "suction_pressure_kpa": 123,
      "discharge_pressure_kpa": 123,
      "humidity_percent": 123,
      "active_alarms": [
        {
          "source_code": "<string>",
          "description": "<string>",
          "severity": "<string>"
        }
      ],
      "location": {
        "type": "<string>",
        "coordinates": {
          "[0]": 123,
          "[1]": 123
        },
        "bbox": {
          "[0]": 123,
          "[1]": 123,
          "[2]": 123,
          "[3]": 123
        }
      },
      "h3_index_11": 123,
      "battery_voltage_unit": "V",
      "ambient_temperature_unit": "K",
      "zones_temperature_unit": "K",
      "remote_probe_statuses_temperature_unit": "K"
    }
  ],
  "total": 1,
  "current_page": "<string>",
  "current_page_backwards": "<string>",
  "previous_page": "<string>",
  "next_page": "<string>"
}
Provisional endpoint
This endpoint is available for early access. The core schema is stable, but minor details — such as field names or added fields — may change before it becomes generally available. Backward compatibility is not guaranteed.

See API Stability & Versioning for details on provisional endpoints.
All units of measure are returned in SI units (e.g., meters, Kelvin, Pa).
When only_latest=true, the from_datetime and to_datetime query parameters are not applied. Only the most recent status per trailer is returned regardless of the date range specified.
When only_latest=false, exactly one trailer_ids value must be specified. To retrieve trailer status history for multiple trailers, make separate requests for each.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

​
only_latest
boolean
default:true

If true, only the latest known status per trailer is returned.

​
fleet_ids
string<uuid>[] | null

Limit results to specific fleets using Catena's fleet IDs. For your own fleet identifiers, use fleet_refs instead To specify multiple values, repeat the parameter for each value (e.g., ?fleet_ids=id1&fleet_ids=id2).

Maximum array length: 100
​
fleet_refs
string[] | null

Limit results to specific fleets using your organization's fleet reference identifiers. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_refs=ref1&fleet_refs=ref2).

Maximum array length: 100
​
connection_id
string<uuid> | null

Limit results to a specific provider connection. This is the UUID assigned by Catena when your fleet connects to a TSP.

​
from_datetime
string<date-time>

Return only records that occurred on or after this date and time. Format: ISO 8601 (UTC) Applies filter: occurred_at >= from_datetime Default value: now() - 1 day Restriction: to_datetime - from_datetime cannot exceed 45 days

Example:

"2026-06-25T15:05:51.529365Z"

​
to_datetime
string<date-time>

Return only records that occurred before this date and time. Format: ISO 8601 (UTC) Applies filter: occurred_at < to_datetime Default value: now() Restriction: to_datetime - from_datetime cannot exceed 45 days

Example:

"2026-06-26T15:05:51.529502Z"

​
trailer_ids
string<uuid>[] | null

Limit results to specific trailers. Maximum: 100 IDs To specify multiple values, repeat the parameter for each value (e.g., ?trailer_ids=id1&trailer_ids=id2).

Maximum array length: 100
​
include_source_data
boolean
default:false

Include the raw data from the telematics provider. Useful for auditing or accessing fields not normalized by Catena

​
cursor
string | null

Cursor for the next page

​
size
integer
default:300

Page size

Required range: 1 <= x <= 1000

Response

Successful Response

​
items
TrailerStatusRead · object[]
required
​
total
integer
required
Required range: x >= 0
​
current_page
string | null

Cursor to refetch the current page

​
current_page_backwards
string | null

Cursor to refetch the current page starting from the last item

​
previous_page
string | null

Cursor for the previous page

​
next_page
string | null

Cursor for the next page