🧪 List Fleet Insurance Signals
Retrieve underwriting signals per fleet reference for your accessible fleets over a requested time window. Each row carries safety event counts (speeding, harsh cornering, harsh braking) summed across the fleet’s vehicles, hours-of-service violations summed across the fleet’s drivers, the distance those vehicles traveled, resolved display names for the fleet’s Catena identifiers, and the number of vehicles behind each. A vehicle reachable through more than one fleet reference is reported under each, so rows can overlap and totals across rows may exceed your actual vehicle count. hos_violation_count is null when your agreement does not grant the scopes needed to compute it for every connection behind the reference — a reference spanning more than one connection is null even if only one of them is missing those scopes, rather than reporting a partial count. The window cannot exceed 90 days.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
Limit results to specific fleets using Catena’s fleet IDs. For your own fleet identifiers, use fleet_refs instead To specify multiple values, repeat the parameter for each value (e.g., ?fleet_ids=id1&fleet_ids=id2).
Limit results to specific fleets using your organization’s fleet reference identifiers. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_refs=ref1&fleet_refs=ref2).
Return only records that occurred on or after this date and time. Format: ISO 8601 (UTC) Applies filter: occurred_at >= from_datetime Default value: now() - 1 day Restriction: to_datetime - from_datetime cannot exceed 90 days
Return only records that occurred before this date and time. Format: ISO 8601 (UTC) Applies filter: occurred_at < to_datetime Default value: now() Restriction: to_datetime - from_datetime cannot exceed 90 days