Skip to main content

Idle/stop summary report (RPT-05)

GET 
/api/v1/reports/idle-stops

Idle/stop rows derived from non-heartbeat DeviceLocation runs per session.

A stop = a maximal run of points within STOP_RADIUS_METERS (50 m) of the run anchor whose span >= threshold_minutes (default 5). Pure-Python haversine over fetched points — no raw geometry SQL.

Retention caveat: stops are only derivable within location_retention_days (~90d) before raw DeviceLocation is cleaned.

Request​

Responses​

OK