Skip to main content

Get resident devices with telemetry (compatibility)

MethodPath
GET/v1/slim/query/patient/:id

Authentication · Access policies

Compatibility route for older resident vitals clients. Returns the devices assigned to one resident, each with its telemetry. For new integrations, use GET /v1/slim/patient/{id}/current-vitals.

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​

  • Returns up to 100 device rows for the resident, with zone, device and telemetry.
  • Results are cached for up to 60 seconds. Writes made through the Slim routes refresh the cache sooner.

Example​

curl -X GET 'https://api.sandbox.ovok.com/v1/slim/query/patient/3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21' \
  -H "Authorization: Bearer ${OVOK_TOKEN}"

Successful response​

200 — Patient query results retrieved successfully.

Errors​

StatusMeaning
401Bearer token is missing, invalid or expired.
403You 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.
422id is not a UUID, or project is not a Project/<id> reference.