---
title: "List a user's notes"
type: reference
method: GET
path: /rest-api/system-users/{userId}/notes.do
tag: "Users"
---

# List a user's notes

`GET https://YOUR-NETWORK-DOMAIN/rest-api/system-users/{userId}/notes.do`

The notes the network left for a user, newest first, as the operator sees them on the user's page. Each note has id, title (null when it has none), text (plain text, line breaks kept), createdAt, createdBy, updatedAt and updatedBy (ISO-8601 UTC times and the authors' usernames; an author whose user was deleted reads null, and updatedAt/updatedBy stay null until the note is first changed), and readAt (when the user marked it as read, ISO-8601 UTC; null while it is unread). 'editable' says whether the caller may add, change and delete them; 'notesTabVisible' whether the user's role shows the Notes tab, without which the user does not see them. Requires the right to view the user.

## Path params

| Name | Type | Required | Example | Description |
|---|---|---|---|---|
| `userId` | integer | yes | `42` | Numeric id of the user, as /rest-api/system-users/search.do reports it |

## Responses

- `200` — {success, notes: [note], editable, notesTabVisible}
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — authentication error
- `403` — The caller may not view users of the target's role
- `404` — No user with this id

## Example request

```bash
curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/system-users/42/notes.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

Source: https://epom.com/ad-server/docs/api/users/get-system-users-notes