Time-on-site / job-site report (RPT-02)
GET/api/v1/reports/time-on-site
Time on each job-site geofence per device per workspace-tz day.
Derived from GeofenceEvent entry/exit pairing (event_type "entry"/"exit",
NOT "enter"). Each entry pairs with the NEXT exit per (device, geofence); an
entry still open at range end clamps its exit to range_end (open interval,
not dropped). SignalEvent signal_type="dwell" enriches the totals where
entry/exit pairing is incomplete.
Precedence: entry/exit-derived seconds are PRIMARY. A dwell signal supplements a (device, geofence, day) bucket only when no entry/exit pairing produced a visit there (so a workflow-only dwell still surfaces job-site time).
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 422
OK
Bad Request
Unauthorized
Forbidden
Not Found
Validation Error