Get Dashboard Stats
GET/api/v1/devices/dashboard-stats
Get KPI statistics for the dashboard ops view.
Returns counts for:
-
live_count: Devices with location update in the last 2 minutes
-
reporting_count: On-shift devices reporting inside the 15-minute heartbeat window
-
expected_reporting_count: Active registrations currently on shift
-
attention_count: On-shift devices outside the 15-minute reporting window
-
paused_count/off_shift_count: Active registrations not expected to report
-
offline_stale_count: Active devices without recent location
-
in_geofence_count: Compatibility alias for last-known geofence membership
-
confirmed_current_geofence_count: Fresh on-shift devices inside a geofence
-
alerts_open: Open alert notifications (dashboard alerts)
-
workflow_failures_1h: Failed workflow executions in the last hour
-
webhook_retries_1h: Webhook deliveries pending retry in the last hour
-
Managers/owners: See stats for all workspace devices
-
Field workers: See stats for only their own device
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
- 500
OK
Bad Request
Unauthorized
Forbidden
Not Found
Validation Error
Internal Server Error