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

> Launch of Telematics Analytics API and response standardization

**Released 11th February 2026**

This minor release introduces the new Telematics Analytics API, standardizes response formats across all endpoints with improved pagination and sorting.

<Info>
  **Note:** This release includes page size reductions for improved performance.
</Info>

## Endpoint Changes

<AccordionGroup>
  <Accordion title="Analytics API (New)" icon="chart-line">
    **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.
  </Accordion>
</AccordionGroup>

## New Query Parameters

Specific endpoints have received new filtering and sorting capabilities.

<AccordionGroup>
  <Accordion title="HOS Events" icon="clock-rotate-left">
    `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
  </Accordion>

  <Accordion title="Trailer Locations" icon="truck-ramp-box">
    `GET /v2/telematics/trailer-locations`

    * `vehicle_ids`: Filter locations by associated vehicle IDs
  </Accordion>

  <Accordion title="Users" icon="users">
    `GET /v2/telematics/users`

    * `is_driver`: Boolean filter to specifically include or exclude drivers
  </Accordion>

  <Accordion title="Sorting & Ordering" icon="arrow-down-short-wide">
    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`
  </Accordion>
</AccordionGroup>

## Limit Adjustments

<Warning>
  The following changes may require updates to your integration.
</Warning>

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

<AccordionGroup>
  <Accordion title="Pagination Totals" icon="list-ol">
    Paginated responses now include a `total` field indicating the total count of records.

    ```json theme={null}
    {
      "items": [...],
      "total": 150,
      "cursor": "..."
    }
    ```
  </Accordion>

  <Accordion title="Fleet References" icon="tag">
    All major resources now include a `fleet_ref` field, providing the external fleet identifier alongside the internal `fleet_id`.

    ```json theme={null}
    {
      "fleet_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91",
      "fleet_ref": "ca-toronto-001"
    }
    ```
  </Accordion>
</AccordionGroup>

## Migration Checklist

<Steps>
  <Step title="Check HOS Page Sizes">
    Ensure your integration does not request more than 500 items per page for HOS endpoints.
  </Step>

  <Step title="Implement Sorting">
    Take advantage of `sort_by` and `sort_order` to refine your data fetching.
  </Step>

  <Step title="Explore Analytics">
    Review the new Analytics API endpoints to access aggregated fleet and driver metrics.
  </Step>
</Steps>

***

## Need Help?

<CardGroup cols={2}>
  <Card title="API Reference" icon="book" href="/api-reference/telematics-api">
    View complete endpoint documentation with current API structure
  </Card>

  <Card title="Contact Support" icon="life-ring" href="mailto:support@catenaclearing.io">
    Questions about migrating your integration? Our team is here to help
  </Card>
</CardGroup>


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