Skip to main content

Read Telemetry Data

Overview​

This tutorial walks through the 3-Telemetry Postman collection. You will check and update sensor settings, retrieve historical data points, and read the latest values using both a user token and an M2M token.

Prerequisites​

  • Completed Get Access Token — accessToken is set
  • Completed Register Your Device — deviceId is set
  • dataObjectId is set — required by Data Points Historical Get and Data Object Blob Get. It is not auto-captured; get it from Get device data objects in the 2-Provisioning&Activation collection (see Device Data Definitions) and set it in your environment.
  • (Optional) Completed M2M Access — cc_access_token is set (required for the client-token request only)

Requests in This Collection​

These requests are independent — there is no required order. Run whichever fits your need.

Sensor Settings​

Sensor Settings Get​

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

Sensor Settings Change​

Updates the telemetry configuration for the device. Fill in the request body with the settings you want to change (e.g. sampling interval, enabled sensor list).

Data Points​

Data Points Historical Get​

Retrieves historical data points for a specific Data Object (dataObjectId) within a time range.

Auto-calculated time range

The pre-request script automatically sets startTime to 60 minutes ago and endTime to 1 minute from now — 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 time calculation directly.

Data Points Latest Get by User Token​

Retrieves the most recent value for every data object on the device, authenticated with accessToken (your interactive login token).

Data Points Latest Get by Client Token​

Retrieves the same latest values, but authenticated with cc_access_token (your M2M token) instead of the user token.

  • API: Get Latest Data Points
  • Result: 200 OK — same result as the user token variant, authenticated with cc_access_token
note

This request demonstrates that M2M tokens have the same read access as user tokens for telemetry data. This is the pattern used by automated services and backend pipelines — no human login required.

Data Object Blob Get​

Downloads a binary value (e.g. image, waveform buffer) stored for a Data Object under a specific blob key. Requires dataObjectId and blobKey.

Last updated on Jul-16, 2026 | Version 1.1.0

On this page ...

Is this helpful?