Skip to main content

Get latest values of all device data streams

GET 
/api/v1/orgs/{orgId}/devices/{deviceId}/data-streams/values/latest

Retrieve all latest data objects from data streams for the device within the system-defined retention period (default: 25 hours).

Parameters

  • deviceId (string, required): Unique ID of the device. Example: 74fe488d5d35

Response Fields:

  • deviceId (string): Device unique ID.
  • time (DateTime): Response generation timestamp, not the individual sample's timestamp.
  • dataStreams (array): One entry per data stream that currently has data. Each item:
    • dataStreamId (Guid): Unique ID of the data stream.
    • dataStreamName (string): Name of the data stream.
    • dataType (string): Data type of the sample value (e.g. double, boolean, integer, string).
    • displayName (string, nullable): Human-readable label.
    • unitDisplay (string, nullable): Display unit (e.g. °C).
    • dataObject (object): Latest sample, with timestamp (DateTime) and value (typed per dataType).

Responses

  • 200 OK: Returns one latest-value entry per data stream that currently has data, including its value, value type, timestamp, and data stream name; streams with no data in the retention window are omitted from the array.
  • 204 No Content: None of the device's data streams have data in the retention window. This is a normal empty-result state, not an error; no retry is needed for the same request, poll again later once the device reports new values.
  • 400 Bad Request: Invalid request parameters.

Security

  • This API requires authentication.

Request​

Responses​

Returns deviceId, time, and dataStreams[]: one latest-value entry per data stream that currently has data (dataStreamId, dataStreamName, dataType, displayName, unitDisplay, dataObject{timestamp,value}); streams with no data in the retention window are omitted.