Get device dwell times for a site or zone

Returns the total time each device spent within a given site or zone during the specified time range. At least one of site_id or zone_id must be provided, and at least two of begin, end, and duration must be supplied. Devices with zero dwell time are excluded from the results.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
int64

The ID of the site to filter by. Required if zone_id is not provided.

int64

The ID of the zone to filter by. If provided alongside site_id, the zone must belong to that site. Required if site_id is not provided.

date-time

Start time in RFC 3339 format (e.g., 2025-08-06T20:22:06Z). Optional if end and duration are both provided.

date-time

End time in RFC 3339 format (e.g., 2025-08-07T20:22:06Z). Optional if begin and duration are both provided.

string

Duration of the query window (e.g., 1h, 30m, 3600s). Optional if begin and end are both provided. At least two of begin, end, and duration must be supplied.

Responses

400

Invalid parameters — site_id/zone_id both missing, invalid time range, or begin older than the allowed maximum.

401

Missing or invalid authorization token.

404

Site or zone not found, or access denied.

500

Internal server error.

Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json