# Get project device counts

Canonical page: https://docs.ovok.com/api/slim/project/get-project-device-counts

`GET /v1/slim/project/{id}/device-counts`

Returns summary counts of the devices in a project: total, assigned to a resident, active and by manufacturer. Use it for project overview tiles.

**Auth:** Bearer token. The caller's access policy must grant `Device:search` and `Device:read` (a project admin who holds no access policy skips this check).
**Scope:** The project in the path. It must be the caller's project (from the token) or a direct child of it.

## Behaviour

- Counts come from the project's live device list, the same rows that back the live device views. That list is cached, so a device change can take a moment to show.
- A row is left out when its device, resident, location or organization belongs to another project.
- `assignedResidentDeviceCount` counts devices with a resident; `unassignedDeviceCount` is the rest.
- `activeDeviceCount` counts devices whose latest telemetry reports them active; `inactiveDeviceCount` is the rest.
- `withingsDeviceCount` counts devices whose serial number resolves to Withings. Every other device is counted in `radarDeviceCount`.
- If the device list fails to build, the last complete list is used.


## Example

```bash
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/project/c3499c27-2973-0a7f-807e-fb8676a92dcb/device-counts' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```
