Skip to navigation
IntelligenceFleet 360

🧪 Get a Fleet’s Combined Telematics + SAFER Profile

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.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

fleet_idstring or nullOptionalformat: "uuid"

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

fleet_refstring or nullOptional
Look up the fleet using your organization's fleet reference identifier.
connection_idstring or nullOptionalformat: "uuid"
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
connection_idstringformat: "uuid"
Provider connection this profile was resolved through.
tsp_vehicle_countinteger
Count of vehicles ingested from this fleet's connected TSPs.
fleet_idstring or nullOptionalformat: "uuid"
Internal fleet identifier.
fleet_refstring or nullOptional
External fleet reference in the partner system.
dot_numberstring or nullOptional
USDOT number linked to this fleet, if known.
fleet_infoobject or nullOptional

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

saferobject or nullOptional

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

fmcsa_power_unitsinteger or nullOptional

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

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
405
Method Not Allowed Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
501
Not Implemented Error