> ## 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.

# Telematics API v2 Endpoint Overview

> Reference overview of the Telematics API v2 endpoint surface, grouped by functional area.

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](/api-reference/changelogs).

<Check>
  **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.
</Check>

***

## Fleet Operations & Tracking

<AccordionGroup>
  <Accordion title="Vehicles" icon="truck">
    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

    ```bash theme={null}
    # 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
    ```
  </Accordion>

  <Accordion title="Trailers" icon="trailer">
    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

    ```bash theme={null}
    # 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
    ```
  </Accordion>

  <Accordion title="Fleet info & fuel" icon="gas-pump">
    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

    ```bash theme={null}
    # List fuel transactions
    GET https://api.catenatelematics.com/v2/telematics/fuel-transactions

    # List IFTA summaries
    GET https://api.catenatelematics.com/v2/telematics/ifta-summaries
    ```
  </Accordion>
</AccordionGroup>

***

## Drivers & Users

<AccordionGroup>
  <Accordion title="Users" icon="user">
    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

    ```bash theme={null}
    # List users
    GET https://api.catenatelematics.com/v2/telematics/users
    ```
  </Accordion>
</AccordionGroup>

***

## Compliance & Regulation

<AccordionGroup>
  <Accordion title="Hours of Service (HOS)" icon="clock">
    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

    ```bash theme={null}
    # List HOS events
    GET https://api.catenatelematics.com/v2/telematics/hos-events

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

  <Accordion title="DVIR logs" icon="clipboard-check">
    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

    ```bash theme={null}
    # 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
    ```
  </Accordion>
</AccordionGroup>

***

## Safety & Driver Behavior

<AccordionGroup>
  <Accordion title="Driver safety events" icon="shield-halved">
    Monitor driver safety events to improve fleet safety and reduce risk.

    **Added:**

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

    ```bash theme={null}
    # List driver safety events
    GET https://api.catenatelematics.com/v2/telematics/driver-safety-events
    ```
  </Accordion>
</AccordionGroup>

***

## Workflows, Messages & Documents

<AccordionGroup>
  <Accordion title="Workflows" icon="list-check">
    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

    ```bash theme={null}
    # Create a workflow
    POST https://api.catenatelematics.com/v2/telematics/workflows
    ```
  </Accordion>

  <Accordion title="Messages & group messages" icon="message">
    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

    ```bash theme={null}
    # Send a message
    POST https://api.catenatelematics.com/v2/telematics/messages

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

  <Accordion title="Documents & TMS loads" icon="file">
    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

    ```bash theme={null}
    # List documents
    GET https://api.catenatelematics.com/v2/telematics/documents
    ```
  </Accordion>
</AccordionGroup>

***

## Analytics

<AccordionGroup>
  <Accordion title="Fleet, vehicle & trailer analytics" icon="chart-line">
    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

    ```bash theme={null}
    # 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
    ```
  </Accordion>
</AccordionGroup>

***

## Reference Data

<AccordionGroup>
  <Accordion title="HOS reference tables" icon="table">
    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

    ```bash theme={null}
    # List HOS rulesets
    GET https://api.catenatelematics.com/v2/telematics/ref-hos-rulesets
    ```
  </Accordion>
</AccordionGroup>

***

## Need help?

<CardGroup cols={2}>
  <Card title="API reference" icon="book" href="/api-reference/telematics-api">
    View complete endpoint documentation with the full Telematics API reference.
  </Card>

  <Card title="Contact support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about integrating with the new endpoints? Our team is here to help.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.