Read Telemetry Data

Overview

This tutorial walks through the 3-Telemetry Postman collection. You will check and update sensor settings, list the device's DataStreams, and read both the latest value and a historical range.

Every sensor a device reports becomes one DataStream. Values are always queried per DataStream, so listing them comes first — that is where you get the dataStreamId the other requests need.

Prerequisites

• Completed Get Access Token — accessToken is set
• Completed Manage Organizations — org_id is set, since every DataStream request is org-scoped
• Completed Register Your Device — deviceId is set, and the device is Activated and syncing

Requests in This Collection

Run Data Stream List first — it captures dataStreamId for the three requests that follow. The two Sensor Settings requests are independent and can be run at any time.

---

Sensor Settings

Sensor Settings Get

Retrieves the device's current telemetry configuration — which sensors are enabled and at what collection frequency.

• API: Get Telemetry Configurations
• Result: 200 OK — the current telemetry config for the device

---

Sensor Settings Change

Updates the telemetry configuration for the device. The request body is an array of device configs, each listing the sensors to change with their enabled flag and sampling interval in milliseconds.

• API: Update Telemetry Configurations
• Result: 202 Accepted — the change is queued and applied on the device asynchronously

---

DataStreams

Data Stream List

Lists every DataStream on the device, with its dataStreamName, displayName, unitDisplay, dataType, and whether it is System- or User-managed.

• API: List DataStreams
• Result: 200 OK — a paged items array
• Script: the Tests tab looks for a DataStream named cpu_usage, falls back to the first item, and writes dataStreamId and dataStreamName into your environment

Run this first

The next three requests all target {{dataStreamId}}. Running Data Stream List once populates it for you — no manual copying. To query a different sensor, either edit the Tests script's target name or set dataStreamId yourself from the response.

---

Data Stream Latest Value Get

Retrieves the most recent sample for one DataStream, within the system-defined retention period (default 60 minutes).

• API: Retrieve Latest Value
• Result: 200 OK — a flat object with dataStreamName, dataType, and a dataObject holding timestamp and value

---

Data Stream Historical Values Get

Retrieves historical samples for one DataStream within a time range.

• API: Get Historical Data
• Result: 200 OK — up to 1,000 samples within the time window

Auto-calculated time range

The pre-request script sets startTime to 60 minutes ago and endTime to 1 minute from now, both URL-encoded ISO 8601 — you do not need to fill in any time values manually.

To use a custom range, open the request's Pre-request Script tab and adjust the calculation.

---

Data Stream Blob Get

Downloads the binary payload of a DataStream whose dataType is a MIME type such as image/png or application/octet-stream. Requires dataStreamId and blobKey.

• API: Download Binary Data
• Result: 200 OK — the binary payload for the requested blob key

---

Related

• Deploy Container Stack — next step in the collection sequence
• DataStreams — API reference
• Data Engine — how DataStreams, Analyzers, and Bridges fit together

---

Last updated on Aug-2, 2026 | Version 1.1.1