List devices with telemetry (compatibility)

Method	Path
GET	/v1/slim/query

Authentication · Access policies

Compatibility route for older query clients. Returns device rows joined with their resident, location, zone and telemetry. For new integrations, use GET /v1/slim/device/live or the /v1/slim/patient routes.

Auth: bearer token. The caller must be a practitioner, an admin or a System Owner, and needs search and read on Patient, Device, Location, Observation and Organization. Scope: the caller's project (from the token). The project parameter is ignored.

Behaviour

• mustInclude lists the resources a row must have to be returned. shouldInclude lists the resources added to each row when present. Both are comma-separated lists of organization, device, location, patient and telemetry.
• Every entry in mustInclude must also be in shouldInclude. telemetry in either list needs device in the same list.
• When mustInclude contains patient, the query runs on the older resident-oriented path, which reads telemetry from the device database and Redis. Otherwise it runs on the same path as GET /v1/slim/device/live.
• Without includeUnassigned=true, rows without a resident are left out when patient is required.
• organization takes Organization/<id>, assigned or unassigned.
• page is zero-based. count defaults to 20, maximum 100.
• The route returns 503 when the server is at capacity for live reads or the device list cannot be built. Retry shortly.

Example

curl -X GET 'https://api.sandbox.ovok.com/v1/slim/query?mustInclude=device,telemetry&shouldInclude=organization,device,location,patient,telemetry&page=0&count=20' \
  -H "Authorization: Bearer ${OVOK_TOKEN}"

Successful response

200 — Query results retrieved successfully.

Errors

Status	Meaning
401	Bearer token is missing, invalid or expired.
403	You are not a practitioner, admin or System Owner, you lack search or read on Patient, Device, Location, Observation or Organization, your session has no project, or you cannot access the project.
422	A query parameter fails validation.