---
title: "List the notes left for me"
type: reference
method: GET
path: /rest-api/user-preference/notes.do
tag: "Users"
---

# List the notes left for me

`GET https://YOUR-NETWORK-DOMAIN/rest-api/user-preference/notes.do`

The notes the network left for the signed-in user, as their Notes tab shows them: newest first, each with id, title (null when it has none), text (plain text, line breaks kept), date (when the note was written, ISO-8601 UTC) and readAt (when the user marked it as read, ISO-8601 UTC; null while it is unread, and again after the network changes its title or text). Who wrote a note is not shown. Requires the NOTES_TAB_VISIBLE permission, as the tab does.

## Responses

- `200` — {success, notes: [{id, title, text, date, readAt}]}
- `400` — Bad request — invalid or missing parameters
- `401` — Unauthorized — authentication error
- `403` — The role does not show the Notes tab (NOTES_TAB_VISIBLE)

## Example request

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

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