Skip to main content

Get Vision Camera Online Status

GET 
/vision/status

Returns the current online status of the Vision camera(s) for every camera-capable vehicle on the account.

Status values:

  • online - the device is connected and at least one camera channel is currently active
  • standby - the device is connected but idle (not a fault)
  • offline - the device is connected with no currently active camera channel, is not currently reporting status, or has not sent any status data yet. In the last case cameras is an empty array, since the number of camera channels on the device isn't known yet.

A vehicle is included in the response as soon as its hardware is camera-capable, even if its device has never reported a status. A vehicle whose hardware has no camera at all is not included.

Note: this endpoint only supports accounts on the HLS video streaming protocol. Accounts on the WebSocket protocol receive an HTTP 422 (see the 422 response below) - support for the WebSocket protocol is planned for a future release.

Note: This endpoint is subject to a rate limit, allowing a maximum of 6 requests per minute. See https://developer.cartrack.com/docs/fleet-api-general/rate-limiting for more information.

Note: This service is available exclusively for Cartrack Vision API enabled accounts. If you do not have access (HTTP 403), contact our sales representative.

Request​

Responses​

Successful operation