Skip to main content
GET
List device timeseries
Each row is one recorded status: KODE OS records one per 1-minute window in which the device’s points receive data, so consecutive rows can carry the same status. To find when a device went down or came back, compare each row with the one before it.
The range between from and to has the same day limit as List point timeseries. Split longer ranges into multiple requests.
Both bounds are inclusive. from and to need a UTC offset, for example 2026-11-01T00:00:00Z or 2026-11-01T00:00:00+05:30. A value without an offset is rejected. A page past the end returns an empty data array with the real itemCount.

Authorizations

Authorization
string
header
required

Paste an access token from Create an access token. Tokens expire, so request a new one if you receive 401.

Path Parameters

buildingId
string
required

Building identifier from List buildings.

deviceId
string
required

Device identifier.

Query Parameters

page
integer
default:1

Page number to return. The first page is 1.

Required range: x >= 1
limit
integer
default:50

Maximum number of items per page.

Required range: 1 <= x <= 200
from
string<date-time>
required

Start of the time range, inclusive. ISO 8601 date-time with an offset.

to
string<date-time>
required

End of the time range, inclusive. ISO 8601 date-time with an offset.

Response

A page of recorded statuses.

data
object[]
page
integer<int32>
Example:

1

limit
integer<int32>
Example:

50

pageCount
integer<int32>
Example:

1

itemCount
integer<int32>
Example:

1