Skip to navigation
IntelligenceFleet 360

🧪 List a Fleet’s SAFER Authority Revocations

Retrieve operating authority revocations for the fleet linked to the given identifier, ordered by effective date, most recent first. Identify the fleet using exactly one of fleet_id, fleet_ref, connection_id, vehicle_id, or vin. Returns an empty list if the fleet is accessible but not yet linked to a SAFER record.

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.
vehicle_idstring or nullOptionalformat: "uuid"
Look up the fleet that operates this vehicle, using Catena's vehicle ID.
vinstring or nullOptional
Look up the fleet that operates the vehicle with this VIN.

Response

Successful Response
idstringformat: "uuid"
registryenum

Registry/authority that maintains the carrier record

Allowed values:
authority_numberstring
created_atdatetime
updated_atdatetime
fleet_registry_idstring or nullOptional
license_typeenum or nullOptional
Type of operating license subject to a revocation action
Allowed values:
order_served_datedate or nullOptional
revocation_typeenum or nullOptional
Whether a revocation was initiated by the carrier or the authority
Allowed values:
effective_datedate or nullOptional

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