Stay informed about changes to the Catena API, including new features, improvements, and breaking changes.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.
This minor release introduces the new Telematics Analytics API, standardizes response formats across all endpoints with improved pagination and sorting.View full changelog →
Key Changes
- Analytics API: Added 11 new endpoints for comprehensive fleet, driver, and vehicle analytics
- Response Standardization: Added
totalto paginated responses andfleet_refto resources - Sorting: Added sorting capabilities to listing endpoints
- Schema Updates: Standardized Vehicle Location and ID field schemas
This patch release clarifies the validation constraints for fleet reference fields in the API documentation and improves example values. No functional API behavior has changed.View full changelog →
Key Changes
- Fleet Reference Validation: Documented validation constraint that only letters, numbers, spaces, dashes, and underscores are allowed in fleet reference fields
- Documentation Clarity: Updated
fleet_refdescriptions across FleetCreate, OnboardingInvitation, and ShareAgreement schemas - Example Improvement: Enhanced ShareAgreement.fleet_ref example from empty string to realistic value (“FLEET-12345”)
- No Functional Changes: Validation rules remain unchanged from previous versions
This patch release clarifies the validation constraints for fleet name fields in the API documentation. No functional API behavior has changed.View full changelog →
Key Changes
- Fleet Name Validation: Documented validation constraint that only letters, numbers, and spaces are allowed in fleet name fields
- Documentation Clarity: Updated
FleetUpdate.fleet_nameandOnboardingInvitation.partner_provided_fleet_namedescriptions - No Functional Changes: Validation rules remain unchanged from previous versions
This minor release introduces comprehensive trailer tracking capabilities with full webhook event support, adds a new telematics service provider, and significantly expands timezone coverage for global operations.View full changelog →
Key Changes
- Trailer Webhook Events: New
trailer.*events for tracking trailer lifecycle (added, modified, removed) - Trailer Location Events: New
trailer_location.*events for real-time trailer location tracking with GeoJSON coordinates - New TSP Support: Added
lioneighttelematics service provider - Global Timezone Expansion: Added 30+ timezone codes covering Mexico, Central/South America, Europe, Africa, Middle East, Asia, and Australia
- Backward Compatibility: All changes are additive with no breaking changes to existing integrations
This minor release introduces new webhook event types for tracking fleet connection lifecycle events, enabling you to monitor when fleet-level connections are established in your integration.View full changelog →
Key Changes
- New Webhook Events:
fleet_connection.createdandfleet_connection.*for monitoring fleet connection lifecycle - Documentation Enhancement: Clarified that connections represent data ingestion from Telematics Service Providers (TSPs)
- Backward Compatibility: All changes are additive with no breaking changes to existing integrations
This minor release introduces trailer location tracking capabilities, enabling you to retrieve historical and current location data for trailers in your fleet.View full changelog →
Key Changes
- New Endpoint:
GET /v2/telematics/trailer-locationsfor retrieving trailer location data - TrailerLocation Schema: Comprehensive data model with GeoJSON coordinates, H3 indexing, and full audit trail
- Fleet Filtering: Support for
fleet_ids,fleet_refs, andtrailer_idsquery parameters - Latest-Only Mode:
only_latestparameter for real-time tracking vs. historical analysis - Backward Compatibility: All changes are additive with no breaking changes to existing integrations
This minor release adds fleet-based filtering capabilities to the connections endpoint and extends the Connection schema with partner system reference tracking.View full changelog →
Key Changes
- Fleet Filtering: New
fleet_idsandfleet_refsquery parameters for filtering connections by fleet - Connection Fleet Reference: New
fleet_reffield added to Connection schema for partner system reference tracking - Backward Compatibility: All changes are additive with no breaking changes to existing integrations
This minor release adds partner system reference tracking across all telematics resources.View full changelog →
Key Changes
- Fleet Reference Field: New
fleet_reffield added to 8 major schemas for partner system reference tracking - Backward Compatibility: All changes are additive with no breaking changes to existing integrations
This minor release makes partner properties endpoints publicly available, streamlines the partner update schema, and refines security scopes for better access control.View full changelog →
Key Changes
- Partner Properties Endpoints: Three endpoints now publicly available for managing custom partner metadata
- Partner Update Endpoint: Now publicly available for updating partner organization details
- Security Scopes: Refined scopes for partner properties from
partner:*topartner-property:*
This patch release expands Hours of Service (HOS) compliance coverage by adding 42 new ruleset codes for oil transport, oil well operations, and property carrier variations.View full changelog →
Key Changes
- Oil Transport Rulesets: Added 20 new codes for interstate/intrastate oil transport operations
- Oil Well Operations: Added 18 new codes for oil well service operations
- Property Carrier Variations: Added 2 sleeper berth variation codes for 60/7 and 70/8 rules
- Backward Compatibility: All changes are additive enum expansions with no breaking changes
This patch release enhances API documentation with comprehensive examples for all major schemas and clarifies field descriptions. No functional API behavior has changed.View full changelog →
Key Changes
- Schema Examples: Added realistic examples for Fleet, Invitation, Share Agreement, Partner, and TSP schemas
- Invitation Expiration: Extended maximum expiration time from 7 days to 28 days
- Documentation Clarity: Improved descriptions for share agreement status values and callback URLs
Major API improvements including standardized filtering, consistent parameter naming, reorganized endpoints, and enhanced error responses.View full changelog →
Key Changes
- Endpoint Reorganization: Reference data endpoints now use
ref-*pattern instead ofrefs/* - Vehicle Locations Unified: Single endpoint with
only_latestparameter replaces multiple endpoints - Standardized Parameters: All list endpoints now use
from_datetime/to_datetimeand plural ID filters - Enhanced Error Responses: Expanded status codes with detailed error messages
- New Features: HOS daily summaries, DVIR defects listing, and enhanced fleet scoping
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