Skip to main content

Get paginated telemetry data for a specific data object

GET 
/api/v1/devices/{deviceId}/inputs/data-objects/{dataObjectName}

Retrieve telemetry records of a specific data object channel for a device within a time range, returned in paginated format with offset-based pagination.

Query Parameters

  • deviceId (string, required): Unique identifier of the device. Example: 74fe488d5d35
  • dataObjectName (string, required): Name of the data object channel to query. Example: voltage, temperature, cpuUsage
  • start (DateTime, required): Start timestamp of the query time range in ISO 8601 format. Example: 2025-09-01T00:00:00Z
  • end (DateTime, required): End timestamp of the query time range in ISO 8601 format. Example: 2025-09-02T00:00:00Z
  • skipCount (integer, optional): Number of records to skip for pagination. Default: 0
  • maxResultCount (integer, optional): Maximum number of records to return per page. Default: 10

Response

Returns a paginated list containing:

  • items: Array of telemetry records for the specified data object
  • totalCount: Total number of records matching the criteria

Performance Note

For large datasets with deep pagination (page 100+), consider using the cursor-based pagination endpoint /devices/{deviceId}/inputs/data-objects for better performance.

Security

  • This API requires authentication.

Request​

Responses​

OK