🧪 List a Fleet’s SAFER Inspection History

GET

https://api.catenatelematics.com/v2/intelligence/fleet-360/inspections

GET

/v2/intelligence/fleet-360/inspections

curl https://api.catenatelematics.com/v2/intelligence/fleet-360/inspections \
     -H "Authorization: Bearer <token>"

{
  "items": [
    {
      "id": "string",
      "registry": "fmcsa",
      "fleet_registry_id": "string",
      "source_inspection_id": "string",
      "viol_total": 1,
      "oos_total": 1,
      "driver_viol_total": 1,
      "driver_oos_total": 1,
      "vehicle_viol_total": 1,
      "vehicle_oos_total": 1,
      "hazmat_viol_total": 1,
      "hazmat_oos_total": 1,
      "post_accident": true,
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "report_state": "string",
      "inspection_date": "2023-01-15",
      "inspection_level": 1,
      "authority_number": "string"
    }
  ],
  "total": 1,
  "current_page": "string",
  "current_page_backwards": "string",
  "previous_page": "string",
  "next_page": "string"
}

Retrieve roadside inspection records for the fleet linked to the given identifier, ordered by inspection date, most recent first. Identify the fleet using exactly one of fleet_id, fleet_ref, connection_id, vehicle_id, or vin. 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

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