# List recent alarm notifications

Canonical page: https://docs.ovok.com/api/slim/notifications/list-recent-alarm-notifications

`GET /v1/slim/notifications/recent/alarms`

Lists the newest active device alarms and attention presses for your project. Use it for an alarm bell. It has the same response shape as `GET /v1/slim/notifications/recent/oob`.

**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 `CommunicationRequest:read` and `CommunicationRequest:search` (an admin or super admin who holds no access policy skips this check).
**Scope:** The caller's project (from the token).

## Behaviour

- Device alarms and attention presses are decided by the sending system. Ovok stores and forwards them.
- Returns at most `count` rows (1 to 50, default 20), newest first by event time.
- Always read from the FHIR store, limited to the `deviceAlarm` and `attention` types, so `warm` is `false` and `source` is `fhirStore`.
- `total` counts alarm rows only. It is an estimate, capped at the list result cap (1,000 by default).
- Acknowledge a row with `PATCH /v1/slim/notifications/{id}/ack`; it then leaves this bell.
- Out-of-bed is on `GET /v1/slim/notifications/recent/oob`, medical notifications on `GET /v1/slim/notifications/recent/medical`.

## Example

```bash
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/notifications/recent/alarms?count=20' \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpYXQiOjE3NjcyNjg4MDAsImV4cCI6MTc2NzI3MjQwMH0.Ql3B_ztDvctlyZ2z0vp4sl3ExXRQGkzmxdmTAqxNzZk'
```