# An out-of-bed notification's notes

Canonical page: https://docs.ovok.com/slim-apis/notifications/an-out-of-bed-notifications-notes

| Method | Path |
| --- | --- |
| `GET` | `/v1/slim/notifications/oob/:id/notes` |

[Authentication](/authentication) · [Access policies](/access-policies)

Lists the notes on an out-of-bed notification. A note is a practitioner's comment on a notification, stored as a FHIR `Communication` whose `basedOn` points at the alert. The alert itself is never changed.

**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` (admins and super admins skip this check).
**Scope:** The caller's project (from the token). An alert or note from another project, of another kind, or that does not exist answers the same 404.

## Request [#request]

### Path parameters [#path-parameters]

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string (uuid)` | Yes | The notification row's `commId` from `GET /v1/slim/notifications/oob`. |

No query parameters or body.

## Behaviour [#behaviour]

- `id` is the notification row's `commId`.
- Newest first. At most 200 notes are returned. Deleted notes are not listed.
- An id that belongs to an alarm notification answers 404: use `GET /v1/slim/notifications/alarms/:id/notes` for those.
- Read-only.

## Example [#example]

```bash
curl -X GET 'https://api.sandbox.ovok.com/v1/slim/notifications/oob/3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21/notes' \
  -H "Authorization: Bearer ${OVOK_TOKEN}"
```

## Successful response [#successful-response]

`200` — The notes on this notification, newest first.

```json
{
  "total": 2,
  "resources": [
    {
      "id": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b22",
      "target": { "kind": "oob", "id": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21" },
      "patientId": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b23",
      "text": "Resident was in the bathroom; back in bed 02:14.",
      "author": { "practitionerId": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b24", "name": "Demo Nurse" },
      "createdAt": "2026-10-09T02:14:40.120Z",
      "updatedAt": "2026-10-09T02:20:05.511Z"
    },
    {
      "id": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b25",
      "target": { "kind": "oob", "id": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b21" },
      "patientId": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b23",
      "text": "Checked on the resident.",
      "author": { "practitionerId": "3f1c2b7e-8d4a-4c1e-9b2f-6a7d5e4c3b26", "name": "Demo Carer" },
      "createdAt": "2026-10-09T01:58:12.345Z",
      "updatedAt": "2026-10-09T01:58:12.345Z"
    }
  ]
}
```

| Field | Type | Description |
| --- | --- | --- |
| `total` | `integer` | The number of notes in `resources`, at most 200. It is not a count of notes beyond that cap. |
| `resources` | `object[]` | The notes, newest first. An empty array when there are none. |
| `resources[].id` | `string (uuid)` | The note's id. Use it with the edit, replace and delete routes. |
| `resources[].target` | `object` | The notification the note was written on. |
| `resources[].target.kind` | `"oob"` \| `"alarm"` \| `"medical"` \| `"alert"` | The kind of notification. A note written on a raw Signals alert and listed on that alert's episode keeps `"alert"`. |
| `resources[].target.id` | `string` | The notification's id: the row's `commId` for `oob` and `alarm`, the row's `episode.id` for `medical`, the raw alert's `id` for `alert`. |
| `resources[].patientId` | `string (uuid) \| null` | The resident's Patient id. `null` when the notification has no resident. |
| `resources[].text` | `string` | The note's text, trimmed. |
| `resources[].author` | `object` | The practitioner who wrote the note. |
| `resources[].author.practitionerId` | `string (uuid) \| null` | The author's Practitioner id. |
| `resources[].author.name` | `string \| null` | The author's display name when the note was written. |
| `resources[].createdAt` | `string (ISO 8601 date-time) \| null` | When the note was written. |
| `resources[].updatedAt` | `string (ISO 8601 date-time) \| null` | When the note was last changed. |

## Errors [#errors]

| Status | Meaning |
| --- | --- |
| [`401`](/errors/unauthenticated) | Bearer token is missing, invalid or expired. |
| [`403`](/errors/forbidden) | You lack `CommunicationRequest:read` or `CommunicationRequest:search`. |
| [`404`](/errors/not-found) | The notification does not exist, or belongs to another project or another kind. |
| [`422`](/errors/validation-failed) | `id` is not a UUID. |
| [`504`](/errors/upstream-timeout) | The FHIR search for notification notes timed out. |
