๐งช Fleet 360
Retrieve a single fleetโs combined view: its TSP-reported company info, ingested vehicle count, and โ where the fleet has been linked to a DOT number โ its FMCSA/SAFER registry record. Identify the fleet using exactly one of fleet_id, fleet_ref, or connection_id.
This endpoint is available for early access. The core schema is stable, but minor details โ such as field names or added fields โ may change before it becomes generally available. Backward compatibility is not guaranteed.
See API Stability & Versioning for details on provisional endpoints.
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
Look up the fleet using Catena's fleet ID. For your own fleet identifiers, use fleet_ref instead
Look up the fleet using your organization's fleet reference identifier.
Look up the fleet using a specific provider connection. This is the UUID assigned by Catena when your fleet connects to a TSP.
Response
Successful Response
Combined telematics + SAFER/FMCSA profile for a single fleet.
dot_number/safer are null when the fleet has not yet been linked to a SAFER
record (no fleet_info.dot_number on file, or no matching FMCSA record found).
Provider connection this profile was resolved through.
Count of vehicles ingested from this fleet's connected TSPs.
Internal fleet identifier.
External fleet reference in the partner system.
USDOT number linked to this fleet, if known.
Fleet-level company/contact info as reported by the TSP.
FMCSA/SAFER registry record for this fleet's DOT number, if linked.
FMCSA-self-reported power unit count for this carrier (mirrors safer.power_units), for direct comparison against tsp_vehicle_count.