Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.catenatelematics.com/llms.txt

Use this file to discover all available pages before exploring further.

​
v2.7.0 - Analytics API
11th February 2026
This minor release introduces the new Telematics Analytics API, standardizes response formats across all endpoints with improved pagination and sorting.
Note: This release includes page size reductions for improved performance.

​
Endpoint Changes

Added:
  • GET /v2/telematics/analytics/drivers - Retrieve driver profiles with compliance metrics including safety events and HOS violations in the last 30 days.
  • GET /v2/telematics/analytics/drivers/time-series - Retrieve daily and cumulative driver counts over a specified period for workforce growth charts.
  • GET /v2/telematics/analytics/fleets - Retrieve aggregated metrics for each fleet including vehicle counts, driver counts, and connection health.
  • GET /v2/telematics/analytics/fleets/time-series - Retrieve daily and cumulative fleet counts over a specified period for growth charts.
  • GET /v2/telematics/analytics/overview - Retrieve a high-level summary of fleet, vehicle, driver, and trailer counts for your organization.
  • GET /v2/telematics/analytics/trailers - Retrieve trailer profiles with identification details and latest location data for asset tracking.
  • GET /v2/telematics/analytics/trailers/live-locations - Retrieve real-time trailer locations and associated vehicle/driver information for live asset tracking.
  • GET /v2/telematics/analytics/trailers/time-series - Retrieve daily and cumulative trailer counts over a specified period for asset growth charts.
  • GET /v2/telematics/analytics/vehicles - Retrieve vehicle profiles with static attributes and latest telemetry snapshot for asset inventories.
  • GET /v2/telematics/analytics/vehicles/live-locations - Retrieve real-time vehicle locations and telemetry (speed, fuel, engine hours) for live fleet maps or dispatch boards.
  • GET /v2/telematics/analytics/vehicles/time-series - Retrieve daily and cumulative vehicle counts over a specified period for growth charts.

​
New Query Parameters

Specific endpoints have received new filtering and sorting capabilities.
GET /v2/telematics/hos-events
  • active_from_datetime: Filter for events active starting from this timestamp
  • active_to_datetime: Filter for events active up to this timestamp
  • event_type_codes: Filter by specific HOS event types
GET /v2/telematics/trailer-locations
  • vehicle_ids: Filter locations by associated vehicle IDs
GET /v2/telematics/users
  • is_driver: Boolean filter to specifically include or exclude drivers
The following endpoints now support sort_by and sort_order parameters:
  • GET /v2/telematics/driver-safety-events
  • GET /v2/telematics/dvir-defects
  • GET /v2/telematics/dvir-logs
  • GET /v2/telematics/hos-availabilities
  • GET /v2/telematics/hos-daily-snapshots
  • GET /v2/telematics/hos-violations
  • GET /v2/telematics/ifta-summaries
  • GET /v2/telematics/trailers
  • GET /v2/telematics/vehicle-sensor-events
  • GET /v2/telematics/vehicles
  • GET /v2/telematics/users

​
Limit Adjustments

The following changes may require updates to your integration.

​
HOS Events Limits

  • Page Size Reduction: The maximum size parameter for GET /v2/telematics/hos-events has been reduced from 1000 to 500 to improve performance with large event objects.

​
New Features

Paginated responses now include a total field indicating the total count of records.
{
  "items": [...],
  "total": 150,
  "cursor": "..."
}
All major resources now include a fleet_ref field, providing the external fleet identifier alongside the internal fleet_id.
{
  "fleet_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
  "fleet_ref": "ca-toronto-001"
}

​
Migration Checklist

1

Check HOS Page Sizes

Ensure your integration does not request more than 500 items per page for HOS endpoints.
2

Implement Sorting

Take advantage of sort_by and sort_order to refine your data fetching.
3

Explore Analytics

Review the new Analytics API endpoints to access aggregated fleet and driver metrics.

​
Need Help?

API Reference

View complete endpoint documentation with current API structure

Contact Support

Questions about migrating your integration? Our team is here to help