Get a device's site/zone transition history

Returns the ordered list of presence intervals for a single device during the specified time range, including periods where the device was not inside any site. Each record spans from the first time the device was seen in a given state (in a site/zone, or outside all sites) until the first time it was seen in a different state. Records where the device was not in any site have site_id, site_name, zone_id, and zone_name all set to null. enter_time may precede begin if the device was already in that state when the window opened; exit_time may follow end if the device was still in that state when the window closed, and is null only when the device is still there at query time. Leaving a zone while remaining in the site produces a new record with a null zone_id. At least two of begin, end, and duration must be supplied.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Identifier of the device whose transition history is requested.

Query Params
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 — invalid time range, or begin older than the allowed maximum.

401

Missing or invalid authorization token.

404

Device 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