# Get project patient counts

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

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

Returns summary counts of the residents in a project by state: active, recently discharged, discharged and archived. Use it for project overview tiles.

**Auth:** Bearer token. The caller's access policy must grant `Patient:search` and `Patient: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, so only residents linked to a device row are counted. A resident without a device is not included.
- Each resident is counted once, even when linked to several devices.
- A row is left out when its device, resident, location or organization belongs to another project.
- The device list is cached, so a change can take a moment to show. If the 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/patient-counts' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```