Skip to main content

Get patient current vitals

MethodPath
GET/v1/slim/patient/:id/current-vitals

Authentication · Access policies

Returns the latest live telemetry for a resident: one entry per device assigned to them, with the device, resident and zone.

Auth: Bearer token. The caller must be a practitioner, an admin, a super admin, or hold the "System Owner" access policy. The access policy must grant search and read on Patient, Device, Location, Observation and Organization (admins and super admins skip this check). Scope: The caller's project (from the token). A resident outside that project returns total: 0 and no entries.

Behaviour​

  • Read-only.
  • Returns one entry per device assigned to the resident, up to 100. A resident with no device returns total: 0.
  • The response is cached for up to 60 seconds, so telemetry can lag the latest reading by up to a minute.

Example​

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

Successful response​

200 — Patient current vitals 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.