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

> 2 changes across webhooks, fleet and analytics

**Released 30th June 2026**

## Vehicle Utilization Benchmarks

This release introduces a new vehicle utilization benchmarking endpoint under the Intelligence API, enabling you to compare individual vehicle utilization against cohort benchmarks.

<Check>
  **Backward-compatible release:** All existing endpoints and integrations continue to work without any changes.
</Check>

### New features

<AccordionGroup>
  <Accordion title="Vehicle utilization benchmarks" icon="chart-bar">
    A new endpoint is available under the `Benchmarks` category of the Intelligence API. Use it to retrieve utilization benchmark data for a specific vehicle, including cohort statistics and benchmark windows.

    ```bash theme={null}
    GET /v2/intelligence/benchmarks/vehicles/{vehicle_id}/utilization
    ```

    **Path parameters:**

    | Parameter | Type | Description |
    | - | - | - |
    | `vehicle_id` | string | The unique identifier of the vehicle to benchmark. |

    **Response:** Returns a `VehicleUtilizationBenchmark` object containing `CohortStats` and `BenchmarkWindow` data for the requested vehicle.

    **Example request:**

    ```bash theme={null}
    curl -X GET "https://api.catenatelematics.com/v2/intelligence/benchmarks/vehicles/{vehicle_id}/utilization" \
      -H "Authorization: Bearer <token>"
    ```
  </Accordion>
</AccordionGroup>

### New schemas

The following schemas have been added to support the new benchmarking endpoint:

| Schema | Description |
| - | - |
| `VehicleUtilizationBenchmark` | Top-level response object for vehicle utilization benchmark data. |
| `CohortStats` | Statistical summary of utilization metrics across a cohort of vehicles. |
| `BenchmarkWindow` | Defines the time window used for benchmark calculations. |

## Webhook Content Filtering

This release adds a new `content` filter field to the `WebhookFilters` schema, giving you finer control over which webhook events are delivered to your endpoints.

<Check>
  **Backward-compatible:** All existing webhook subscriptions continue to work without any changes. The new `content` field is optional and additive.
</Check>

### Webhook filter enhancements

<AccordionGroup>
  <Accordion title="New content filter field on WebhookFilters" icon="filter">
    The `WebhookFilters` schema now includes a `content` property. This field allows you to filter webhook deliveries based on the content of the event payload, reducing noise and improving the signal-to-noise ratio for your integrations.

    The `content` filter is available on all webhook endpoints:

    * `GET /v2/notifications/webhooks` — list response now includes `content` in each webhook's `filters`
    * `POST /v2/notifications/webhooks` — create a webhook with a `content` filter
    * `GET /v2/notifications/webhooks/{webhook_id}` — retrieve a webhook with its `content` filter
    * `PATCH /v2/notifications/webhooks/{webhook_id}` — update a webhook's `content` filter
    * `POST /v2/notifications/webhooks/{webhook_id}/activate` — activated webhook response includes `content` filter
    * `POST /v2/notifications/webhooks/{webhook_id}/pause` — paused webhook response includes `content` filter

    **Example: Create a webhook with a content filter**

    ```bash theme={null}
    POST /v2/notifications/webhooks
    Content-Type: application/json

    {
      "url": "https://your-endpoint.example.com/webhooks",
      "filters": {
        "content": "your-content-filter-value"
      }
    }
    ```

    **Example: Update an existing webhook to add a content filter**

    ```bash theme={null}
    PATCH /v2/notifications/webhooks/{webhook_id}
    Content-Type: application/json

    {
      "filters": {
        "content": "your-content-filter-value"
      }
    }
    ```
  </Accordion>
</AccordionGroup>

***

## 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 integrating the new benchmarking endpoint? Our team is here to help.
  </Card>
</CardGroup>


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