Skip to main content

List child projects with device counts

MethodPath
GET/v2/slim/project/child

Authentication · Access policies

Returns your current project together with its parent project and its direct child projects, each with its device count. Use it for a project switcher or hierarchy view that shows fleet size.

Auth: Bearer token for a practitioner, project admin or System Owner session. The caller's access policy must grant AccessPolicy:read (project admins skip this check). Scope: The caller's project (from the token).

Behaviour​

  • Same lists as GET /v1/slim/project/child: currentProject, parentProject (null when there is none) and every direct child in childProjects. Grandchildren and children whose project no longer exists are left out.
  • Every project also carries deviceCount: the number of Device resources in that project.
  • settings.timeZone defaults to Europe/Berlin; settings.trendsPeriod defaults to start: "09:00:00" and durationSeconds: 86400.

Example​

curl -X GET 'https://api.sandbox.ovok.com/v2/slim/project/child' \
-H "Authorization: Bearer ${OVOK_TOKEN}"

Successful response​

200 — Project relationships retrieved successfully.

Errors​

StatusMeaning
401The bearer token is missing or invalid, or the session carries no project.
403The session is not a practitioner, admin or System Owner session, or its access policy lacks AccessPolicy:read.