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

> Comprehensive trailer management with webhook events and expanded timezone support

**Released 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.

<Check>
  **Minor Release:** All changes are backward-compatible additions. No breaking changes to existing integrations.
</Check>

## New Webhook Events

<AccordionGroup>
  <Accordion title="Trailer Lifecycle Events" icon="trailer">
    **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:**

    ```json theme={null}
    {
      "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"
      }]
    }
    ```
  </Accordion>

  <Accordion title="Trailer Location Events" icon="location-dot">
    **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:**

    ```json theme={null}
    {
      "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"
      }]
    }
    ```
  </Accordion>
</AccordionGroup>

## New Resources

<AccordionGroup>
  <Accordion title="Resource Enum Additions" icon="list">
    **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.
  </Accordion>
</AccordionGroup>

## Telematics Service Provider

<AccordionGroup>
  <Accordion title="New TSP Support" icon="plug">
    **Added:**

    * `lioneight` - Added to supported telematics service providers

    This TSP is now available for fleet connections and data ingestion.
  </Accordion>
</AccordionGroup>

## Timezone Expansion

<AccordionGroup>
  <Accordion title="Global Timezone Coverage" icon="globe">
    **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.
  </Accordion>
</AccordionGroup>

## Integration Guide

<Steps>
  <Step title="Subscribe to Trailer Events">
    Update your webhook subscriptions to include trailer events:

    ```bash theme={null}
    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:

    ```json theme={null}
    {
      "events": ["trailer.*", "trailer_location.*"]
    }
    ```
  </Step>

  <Step title="Handle Trailer Webhook Events">
    Process incoming trailer events in your webhook handler:

    ```javascript theme={null}
    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');
    });
    ```
  </Step>

  <Step title="Update Timezone Handling">
    If your application handles international fleets, update timezone configurations to support the new codes:

    ```javascript theme={null}
    const supportedTimezones = [
      'America/Mexico_City',
      'Europe/London',
      'Asia/Tokyo',
      'Australia/Sydney',
      // ... other new timezones
    ];
    ```
  </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.