Skip to main content

List last-received observation ids by device

MethodPath
GET/v1/slim/telemetry/lastIds

Authentication · Access policies

Returns the last-received Observation ids for every device in your project, keyed by device identifier.

Auth: bearer token. The caller must be a practitioner, an admin or a System Owner, and needs Device:read and Device:search. Scope: the caller's project (from the token).

Behaviour​

  • Covers the devices that have telemetry, up to the first 1000 devices of the project, including devices without a resident.
  • Each value has the same shape as GET /v1/slim/telemetry/{deviceId}/lastIds. Fields are null when nothing has been received for them.

Example​

curl -X GET 'https://api.sandbox.ovok.com/v1/slim/telemetry/lastIds' \
-H "Authorization: Bearer ${OVOK_TOKEN}"

Successful response​

200 — Last-received observation ids, keyed by device identifier.

Errors​

StatusMeaning
401Bearer token is missing, invalid or expired.
403You are not a practitioner, admin or System Owner, you lack Device:read or Device:search, your session has no project, or you cannot access the project.
404Your session has no project (admin sessions only).