Telematics API v2 Endpoint Overview

This page is a reference overview of the Telematics API v2 endpoint surface, grouped into six functional areas. It covers the full lifecycle of fleet operations — from real-time vehicle and trailer tracking to HOS compliance, driver safety, fuel transactions, DVIR logs, and analytics. It is not a release entry: these endpoints were introduced across many releases. For dated changes, see the changelog index.

Coverage: The v2 Telematics API provides full read and write coverage for vehicles, trailers, drivers, HOS records, DVIR logs, fuel transactions, messages, workflows, and analytics — all normalized across telematics providers.

Fleet Operations & Tracking

Vehicles

Full CRUD support for vehicle records, plus real-time and historical location data.Added:

GET /v2/telematics/vehicles — List all vehicles
POST /v2/telematics/vehicles — Create a vehicle
GET /v2/telematics/vehicles/{vehicle_id} — Get a vehicle by ID
PATCH /v2/telematics/vehicles/{id} — Update a vehicle
GET /v2/telematics/vehicle-locations — List historical vehicle locations
GET /v2/telematics/analytics/vehicles/live-locations — Get live vehicle locations
GET /v2/telematics/vehicle-sensor-events — List vehicle sensor events
GET /v2/telematics/vehicle-region-segments — List vehicle region segments
GET /v2/telematics/engine-statuses — List engine statuses
GET /v2/telematics/engine-logs — List engine logs
GET /v2/telematics/driver-vehicle-associations — List driver-vehicle associations

# List vehicles
GET https://api.catenatelematics.com/v2/telematics/vehicles

# Get live locations for all vehicles
GET https://api.catenatelematics.com/v2/telematics/analytics/vehicles/live-locations

Trailers

Full CRUD support for trailer records, plus real-time and historical location and status data.Added:

GET /v2/telematics/trailers — List all trailers
POST /v2/telematics/trailers — Create a trailer
GET /v2/telematics/trailers/{trailer_id} — Get a trailer by ID
PATCH /v2/telematics/trailers/{id} — Update a trailer
GET /v2/telematics/trailer-locations — List historical trailer locations
GET /v2/telematics/analytics/trailers/live-locations — Get live trailer locations
GET /v2/telematics/trailer-statuses — List trailer statuses
GET /v2/telematics/trailer-vehicle-associations — List trailer-vehicle associations

# List trailers
GET https://api.catenatelematics.com/v2/telematics/trailers

# Get live trailer locations
GET https://api.catenatelematics.com/v2/telematics/analytics/trailers/live-locations

Fleet info & fuel

Access fleet-level summaries and fuel transaction records.Added:

GET /v2/telematics/fleet-info — List fleet info records
GET /v2/telematics/fleet-info/{fleet_info_id} — Get a fleet info record by ID
GET /v2/telematics/fuel-transactions — List fuel transactions
POST /v2/telematics/fuel-transactions — Create a fuel transaction
GET /v2/telematics/ifta-summaries — List IFTA summaries

# List fuel transactions
GET https://api.catenatelematics.com/v2/telematics/fuel-transactions

# List IFTA summaries
GET https://api.catenatelematics.com/v2/telematics/ifta-summaries

Drivers & Users

Users

Full CRUD support for driver and user records.Added:

GET /v2/telematics/users — List all users
POST /v2/telematics/users — Create a user
GET /v2/telematics/users/{user_id} — Get a user by ID
PATCH /v2/telematics/users/{id} — Update a user

# List users
GET https://api.catenatelematics.com/v2/telematics/users

Compliance & Regulation

Hours of Service (HOS)

Comprehensive HOS data including events, daily logs, snapshots, violations, and availabilities.Added:

GET /v2/telematics/hos-events — List HOS events
GET /v2/telematics/hos-events/{hos_event_id}/attachments — List attachments for an HOS event
GET /v2/telematics/hos-daily-logs — List HOS daily logs
GET /v2/telematics/hos-daily-snapshots — List HOS daily snapshots
GET /v2/telematics/hos-availabilities — List HOS availabilities
GET /v2/telematics/hos-violations — List HOS violations

# List HOS events
GET https://api.catenatelematics.com/v2/telematics/hos-events

# List HOS violations
GET https://api.catenatelematics.com/v2/telematics/hos-violations

DVIR logs

Driver Vehicle Inspection Report (DVIR) logs and defect tracking.Added:

GET /v2/telematics/dvir-logs — List DVIR logs
POST /v2/telematics/dvir-logs — Create a DVIR log
GET /v2/telematics/dvir-logs/defects — List all DVIR defects
GET /v2/telematics/dvir-logs/{dvir_log_id}/defects — List defects for a specific DVIR log

# List DVIR logs
GET https://api.catenatelematics.com/v2/telematics/dvir-logs

# List defects for a specific DVIR log
GET https://api.catenatelematics.com/v2/telematics/dvir-logs/{dvir_log_id}/defects

Safety & Driver Behavior

Driver safety events

Monitor driver safety events to improve fleet safety and reduce risk.Added:

GET /v2/telematics/driver-safety-events — List driver safety events

# List driver safety events
GET https://api.catenatelematics.com/v2/telematics/driver-safety-events

Workflows, Messages & Documents

Workflows

Create and manage driver workflows and stops.Added:

GET /v2/telematics/workflows — List workflows
POST /v2/telematics/workflows — Create a workflow
GET /v2/telematics/workflows/{workflow_id} — Get a workflow by ID
PATCH /v2/telematics/workflows/{id} — Update a workflow

# Create a workflow
POST https://api.catenatelematics.com/v2/telematics/workflows

Messages & group messages

Send and receive driver messages and group broadcasts.Added:

GET /v2/telematics/messages — List messages
POST /v2/telematics/messages — Send a message
GET /v2/telematics/group-messages — List group messages
POST /v2/telematics/group-messages — Send a group message

# Send a message
POST https://api.catenatelematics.com/v2/telematics/messages

# Send a group message
POST https://api.catenatelematics.com/v2/telematics/group-messages

Documents & TMS loads

Access driver documents and TMS load records.Added:

GET /v2/telematics/documents — List documents
GET /v2/telematics/tms-loads — List TMS loads
GET /v2/telematics/tms-loads/{load_id} — Get a TMS load by ID

# List documents
GET https://api.catenatelematics.com/v2/telematics/documents

Analytics

Fleet, vehicle & trailer analytics

Time-series and summary analytics for fleets, vehicles, and trailers.Added:

GET /v2/telematics/analytics/overview — Get analytics overview
GET /v2/telematics/analytics/fleets — List fleet analytics summaries
GET /v2/telematics/analytics/fleets/time-series — Get fleet time-series data
GET /v2/telematics/analytics/vehicles — List vehicle analytics summaries
GET /v2/telematics/analytics/vehicles/time-series — Get vehicle time-series data
GET /v2/telematics/analytics/trailers — List trailer analytics summaries
GET /v2/telematics/analytics/trailers/time-series — Get trailer time-series data
GET /v2/telematics/analytics/drivers — List driver analytics summaries
GET /v2/telematics/analytics/drivers/time-series — Get driver time-series data

# Get analytics overview
GET https://api.catenatelematics.com/v2/telematics/analytics/overview

# Get vehicle time-series data
GET https://api.catenatelematics.com/v2/telematics/analytics/vehicles/time-series

Reference Data

HOS reference tables

Lookup tables for HOS rulesets, event codes, violation codes, malfunction codes, record origins, record statuses, and regions.Added:

GET /v2/telematics/ref-hos-rulesets — List HOS rulesets
GET /v2/telematics/ref-hos-event-codes — List HOS event codes
GET /v2/telematics/ref-hos-violation-codes — List HOS violation codes
GET /v2/telematics/ref-hos-malfunction-codes — List HOS malfunction codes
GET /v2/telematics/ref-hos-record-origins — List HOS record origins
GET /v2/telematics/ref-hos-record-statuses — List HOS record statuses
GET /v2/telematics/ref-hos-regions — List HOS regions
GET /v2/telematics/ref-timezones — List timezone codes

# List HOS rulesets
GET https://api.catenatelematics.com/v2/telematics/ref-hos-rulesets

Overview

Authentication

Telematics

Organizations

Integrations

Notifications

Intelligence

Fleet Operations & Tracking

Drivers & Users

Compliance & Regulation

Safety & Driver Behavior

Workflows, Messages & Documents

Analytics

Reference Data

Need help?

API reference

Contact support

​Fleet Operations & Tracking

​Drivers & Users

​Compliance & Regulation

​Safety & Driver Behavior

​Workflows, Messages & Documents

​Analytics

​Reference Data

​Need help?

API reference

Contact support

Fleet Operations & Tracking

Drivers & Users

Compliance & Regulation

Safety & Driver Behavior

Workflows, Messages & Documents

Analytics

Reference Data

Need help?