Skip to main content

[Early Access] List wearable connections

GET /v1/wearables/connections
devhttps://api.sandbox.ovok.com

Early Access — interfaces may change without notice.

Every active wearable connection in the caller's project, across all patients and all providers. The dashboard renders these on the per-resident integrations panel.

Token values themselves are never returned — only the metadata (provider, patient id, remote-user id, expiresAt, scopes). To get the OAuth tokens for a programmatic API call, read the underlying Endpoint resource via the FHIR API; tokens are stored as encrypted extensions.

Example​

curl '<APP_BASE_URL>/v1/wearables/connections' \
  -H 'Authorization: Bearer <token>'

Responses​

CodeDescription
200Success.
400The request could not be operated by the server.
401The resource owner or authorization server denied the request.
404The requested resource could not be found.
422The request could not be validated by the server.
500The server encountered an unexpected condition. Please try again later.

200 → ConnectionListResponseDto (application/json)​

All wearable connections for the caller’s project.

  • connections: object[] (required)
    • id: string (required) — Endpoint resource id holding the connection.
    • provider: string (required)
    • patientId: string (required)
    • remoteUserId: string (required) — Provider-assigned user id (athlete_id, user_id…).
    • expiresAt: number (required) — Epoch ms when the current access token expires.
    • scopes: string[] (required)