Skip to navigation
IntelligenceFleet 360

🧪 List a Fleet’s SAFER Insurance Filings

Retrieve insurance filings 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. Optionally bound the results with from_date/to_date, or set active_only=true to restrict to filings with no cancellation date on file. Returns an empty page 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

active_onlybooleanOptionalDefaults to false

If true, only include filings with no cancellation_date on file (i.e. still in force).

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.
from_datedate or nullOptional

Return only records on or after this date. Format: YYYY-MM-DD

to_datedate or nullOptional

Return only records on or before this date. Format: YYYY-MM-DD

cursorstring or nullOptional
Cursor for the next page
sizeintegerOptional1-1000Defaults to 300
Page size

Response

Successful Response
itemslist of objects
totalinteger>=0
current_pagestring or nullOptional
Cursor to refetch the current page
current_page_backwardsstring or nullOptional
Cursor to refetch the current page starting from the last item
previous_pagestring or nullOptional
Cursor for the previous page
next_pagestring or nullOptional
Cursor for the next page

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