Skip to content
SENS Platform Docs

Read bounded historical measurements for one visible Device.

GET
/v1/devices/{deviceId}/measurements
curl --request GET \
  --url 'https://api.dev.iot-sens.schlossers.at/v1/devices/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/measurements?from=2026-04-15T12%3A00%3A00Z&to=2026-04-15T12%3A00%3A00Z&limit=5000' \
  --header 'Authorization: Bearer <token>'

Requires telemetry:read. Device visibility follows the current inventory scope; every returned measurement is additionally filtered by its historical organization assignment against the caller’s current effective grants. Results are ordered by observedAt and measurementId, both descending. from is inclusive and to is exclusive. The synchronous range may not exceed exactly 30 days.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
deviceId
required
string format: uuid

Query Parameters

Section titled “Query Parameters”
from
required
string format: date-time

Inclusive beginning of the time window.

to
required
string format: date-time

Exclusive end of the time window.

measurementKey
Array<string>
<= 25 items

Optional repeated measurement-key filter; at most 25 values.

limit
integer
default: 5000 >= 1 <= 5000
cursor
string
<= 512 characters

Opaque cursor for the stable descending result order.

Responses

Section titled “Responses”

200

Section titled “200”

Bounded, scope-filtered measurement page.

Media typeapplication/json
object
measurements
required
Array<object>
<= 5000 items
object
measurementId
required
string
>= 1 characters
tenantId
required
string format: uuid
deviceId
required
string format: uuid
deviceTypeId
string format: uuid
deviceFieldDefinitionId
string format: uuid
organizationUnitId
string format: uuid
measurementKey
required
string
>= 1 characters <= 64 characters
value
required
One of:
string
valueType
required
string
Allowed values: gauge counter status event
unit
string
<= 40 characters
observedAt
required
string format: date-time
recordedAt
required
string format: date-time
metadata
object
<= 50 properties
key
additional properties
One of:
string
nextCursor
string
>= 1 characters <= 512 characters
Example
{
  "measurements": [
    {
      "valueType": "gauge"
    }
  ]
}

400

Section titled “400”

A safe platform error response.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED AUTHENTICATION_FAILED AUTHORIZATION_FAILED RESOURCE_NOT_FOUND CONFLICT DEPENDENCY_FAILURE FLOW_FAILURE RATE_LIMITED INTERNAL_ERROR
category
required
string
Allowed values: validation authentication authorization not_found conflict dependency_failure flow_failure rate_limit internal
message
required

Safe client-facing diagnostic message.

string
correlationId
required

Correlation ID for operational investigation.

string
>= 1 characters
details

Safe bounded diagnostic details.

object
key
additional properties
One of:
string
Example
{
  "error": {
    "code": "VALIDATION_FAILED",
    "category": "validation"
  }
}

Headers

Section titled “Headers”
Cache-Control
string
Allowed value: no-store

404

Section titled “404”

A safe platform error response.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED AUTHENTICATION_FAILED AUTHORIZATION_FAILED RESOURCE_NOT_FOUND CONFLICT DEPENDENCY_FAILURE FLOW_FAILURE RATE_LIMITED INTERNAL_ERROR
category
required
string
Allowed values: validation authentication authorization not_found conflict dependency_failure flow_failure rate_limit internal
message
required

Safe client-facing diagnostic message.

string
correlationId
required

Correlation ID for operational investigation.

string
>= 1 characters
details

Safe bounded diagnostic details.

object
key
additional properties
One of:
string
Example
{
  "error": {
    "code": "VALIDATION_FAILED",
    "category": "validation"
  }
}

Headers

Section titled “Headers”
Cache-Control
string
Allowed value: no-store

default

Section titled “default”

A safe platform error response.

Media typeapplication/json
object
error
required
object
code
required
string
Allowed values: VALIDATION_FAILED AUTHENTICATION_FAILED AUTHORIZATION_FAILED RESOURCE_NOT_FOUND CONFLICT DEPENDENCY_FAILURE FLOW_FAILURE RATE_LIMITED INTERNAL_ERROR
category
required
string
Allowed values: validation authentication authorization not_found conflict dependency_failure flow_failure rate_limit internal
message
required

Safe client-facing diagnostic message.

string
correlationId
required

Correlation ID for operational investigation.

string
>= 1 characters
details

Safe bounded diagnostic details.

object
key
additional properties
One of:
string
Example
{
  "error": {
    "code": "VALIDATION_FAILED",
    "category": "validation"
  }
}

Headers

Section titled “Headers”
Cache-Control
string
Allowed value: no-store