Skip to main content
GET
Get a fleet's combined telematics + SAFER profile
Provisional endpoint
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

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

fleet_id
string<uuid> | null

Look up the fleet using Catena's fleet ID. For your own fleet identifiers, use fleet_ref instead

fleet_ref
string | null

Look up the fleet using your organization's fleet reference identifier.

connection_id
string<uuid> | null

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).

connection_id
string<uuid>
required

Provider connection this profile was resolved through.

tsp_vehicle_count
integer
required

Count of vehicles ingested from this fleet's connected TSPs.

fleet_id
string<uuid> | null

Internal fleet identifier.

fleet_ref
string | null

External fleet reference in the partner system.

dot_number
string | null

USDOT number linked to this fleet, if known.

fleet_info
FleetInfoRead · object | null

Fleet-level company/contact info as reported by the TSP.

safer
SaferFleetRead · object | null

FMCSA/SAFER registry record for this fleet's DOT number, if linked.

fmcsa_power_units
integer | null

FMCSA-self-reported power unit count for this carrier (mirrors safer.power_units), for direct comparison against tsp_vehicle_count.