🧪 List a Carrier’s Roadside Inspection Records

GET

https://api.catenatelematics.com/v2/intelligence/safer/fleets/:dot_number/inspections

GET

/v2/intelligence/safer/fleets/:dot_number/inspections

curl https://api.catenatelematics.com/v2/intelligence/safer/fleets/dot_number/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 a carrier, by DOT number. Ordered by inspection date, most recent first. Optionally bound the results with from_date/to_date; carrier history can span decades, so both are unbounded by default.

Authentication

AuthorizationBearer

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

Path parameters

dot_numberstringRequired

Query parameters

registryenumOptional

Registry/authority that maintains the carrier record.

Allowed values:

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