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.6.0 - Trailer Tracking & Global Timezone Expansion
28th January 2026
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.
Minor Release: All changes are backward-compatible additions. No breaking changes to existing integrations.

​
New Webhook Events

Added:
  • trailer.added - Emitted when a new trailer is added to the database
  • trailer.modified - Emitted when trailer details are updated
  • trailer.removed - Emitted when a trailer is removed from the database
  • trailer.* - Wildcard subscription for all trailer events
Schema: The BaseTrailer schema includes comprehensive trailer information:
  • Vehicle identification (VIN, external ID, name)
  • Physical specifications (OEM, model type/year, length, axles)
  • License plate details (country, region)
  • ELD device information (type, ID, serial number, product ID)
  • Operational status and lifecycle timestamps
  • Fleet grouping and segmentation support
Example:
{
  "event_name": "trailer.added",
  "version": "2.6",
  "data": [{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "fleet_id": "123e4567-e89b-12d3-a456-426614174000",
    "vehicle_name": "Trailer-001",
    "vin": "1HGBH41JXMN109186",
    "oem": "Great Dane",
    "model_type": "Dry Van",
    "model_year": 2023,
    "trailer_type": "Dry Van",
    "trailer_length": 53.0,
    "total_axles": 2,
    "is_active": true,
    "status": "IN_SERVICE"
  }]
}
Added:
  • trailer_location.added - Emitted when a new trailer location is recorded
  • trailer_location.modified - Emitted when trailer location data is updated
  • trailer_location.* - Wildcard subscription for all trailer location events
Schema: The BaseTrailerLocation schema provides:
  • GeoJSON Point coordinates (longitude, latitude, optional altitude)
  • H3 geospatial index (resolution 11) for efficient spatial queries
  • Trailer reference (internal ID and source system ID)
  • Full audit trail (created, updated, occurred timestamps)
  • Source tracking (TSP, connection, execution details)
Example:
{
  "event_name": "trailer_location.added",
  "version": "2.6",
  "data": [{
    "id": "660e8400-e29b-41d4-a716-446655440000",
    "trailer_id": "550e8400-e29b-41d4-a716-446655440000",
    "location": {
      "type": "Point",
      "coordinates": [-118.2437, 34.0522]
    },
    "h3_index_11": 622236750252466175,
    "occurred_at": "2026-01-28T10:30:00Z"
  }]
}

​
New Resources

Added to ResourceEnum:
  • trailer - For trailer asset management
  • trailer_location - For trailer location tracking
These resources can now be used in webhook subscriptions, filtering, and access control configurations.

​
Telematics Service Provider

Added:
  • lioneight - Added to supported telematics service providers
This TSP is now available for fleet connections and data ingestion.

​
Timezone Expansion

Added 30+ new timezone codes to TimezoneCodeEnum for comprehensive global coverage:Mexico:
  • America/Mexico_City, America/Cancun, America/Merida, America/Monterrey
  • America/Mazatlan, America/Chihuahua, America/Hermosillo, America/Tijuana
  • America/Matamoros, America/Ojinaga, America/Ciudad_Juarez
Central America:
  • America/Guatemala, America/Belize, America/Tegucigalpa
  • America/Managua, America/Costa_Rica, America/Panama
South America:
  • America/Bogota, America/Lima, America/Santiago
  • America/Argentina/Buenos_Aires, America/Sao_Paulo, America/Montevideo
Caribbean:
  • America/Puerto_Rico
Europe (Western):
  • Europe/London, Europe/Dublin, Europe/Lisbon, Europe/Madrid
  • Europe/Paris, Europe/Brussels, Europe/Amsterdam, Europe/Luxembourg
  • Europe/Berlin, Europe/Zurich, Europe/Vienna, Europe/Rome
Europe (Northern):
  • Europe/Copenhagen, Europe/Stockholm, Europe/Oslo
Europe (Central):
  • Europe/Prague, Europe/Budapest, Europe/Warsaw
Europe (Eastern):
  • Europe/Helsinki, Europe/Tallinn, Europe/Riga, Europe/Vilnius
  • Europe/Belgrade, Europe/Tirane, Europe/Sofia, Europe/Athens
  • Europe/Bucharest, Europe/Kyiv, Europe/Chisinau, Europe/Istanbul
Russia:
  • Europe/Kaliningrad, Europe/Moscow, Europe/Samara
Africa:
  • Africa/Casablanca, Africa/Algiers, Africa/Tunis, Africa/Cairo
  • Africa/Tripoli, Africa/Lagos, Africa/Accra, Africa/Dakar
  • Africa/Abidjan, Africa/Nairobi, Africa/Dar_es_Salaam, Africa/Kampala
  • Africa/Johannesburg, Africa/Maputo, Africa/Windhoek
Middle East:
  • Asia/Dubai, Asia/Riyadh, Asia/Qatar, Asia/Kuwait
  • Asia/Bahrain, Asia/Muscat, Asia/Baghdad, Asia/Amman
  • Asia/Beirut, Asia/Jerusalem
Caucasus & Central Asia:
  • Asia/Baku, Asia/Tbilisi, Asia/Yerevan
  • Asia/Almaty, Asia/Tashkent
South Asia:
  • Asia/Karachi, Asia/Kolkata, Asia/Dhaka
  • Asia/Colombo, Asia/Kathmandu
Southeast Asia:
  • Asia/Bangkok, Asia/Ho_Chi_Minh, Asia/Singapore
  • Asia/Kuala_Lumpur, Asia/Jakarta, Asia/Manila
East Asia:
  • Asia/Shanghai, Asia/Hong_Kong, Asia/Taipei
  • Asia/Seoul, Asia/Tokyo
Australia:
  • Australia/Sydney, Australia/Melbourne, Australia/Brisbane
  • Australia/Adelaide, Australia/Perth, Australia/Darwin
  • Australia/Hobart
Pacific:
  • Pacific/Auckland
These timezone codes enable accurate timestamp normalization and display for fleets operating globally.

​
Integration Guide

1

Subscribe to Trailer Events

Update your webhook subscriptions to include trailer events:
POST /v2/webhooks
{
  "url": "https://your-domain.com/webhooks",
  "events": [
    "trailer.added",
    "trailer.modified",
    "trailer.removed",
    "trailer_location.added",
    "trailer_location.modified"
  ]
}
Or use wildcard subscriptions:
{
  "events": ["trailer.*", "trailer_location.*"]
}
2

Handle Trailer Webhook Events

Process incoming trailer events in your webhook handler:
app.post('/webhooks', (req, res) => {
  const { event_name, data } = req.body;

  switch (event_name) {
    case 'trailer.added':
      // New trailer added to fleet
      console.log('New trailer:', data[0].vehicle_name);
      break;

    case 'trailer_location.added':
      // New location data for trailer
      const [lng, lat] = data[0].location.coordinates;
      console.log(`Trailer at: ${lat}, ${lng}`);
      break;
  }

  res.status(200).send('OK');
});
3

Update Timezone Handling

If your application handles international fleets, update timezone configurations to support the new codes:
const supportedTimezones = [
  'America/Mexico_City',
  'Europe/London',
  'Asia/Tokyo',
  'Australia/Sydney',
  // ... other new timezones
];

​
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