Skip to main content
GET
Get device status
KODE OS derives the status. You do not send it. Values that you push to the points of a device, with an optional point status, are aggregated per device in 1-minute windows. The device is down when its points are down. KODE OS records one status for the device for each 1-minute window in which its points receive data, using the latest value in that window. dateTime is the time of that latest recorded status. It moves forward with new data even when the status stays the same. A device that never reported returns 200 with status and dateTime set to null.

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.

Response

The current status of the device.

deviceId
string

Device identifier.

Example:

"67c977317437671625264e05"

status
enum<string> | null

Connectivity status of the device. null when the device never reported.

Available options:
ok,
down,
fault,
disabled,
no_value,
null
Example:

"ok"

dateTime
string<date-time> | null

Time of the recorded status, in UTC. null when the device never reported.

Example:

"2026-11-01T08:15:00.000Z"