---
title: "Count my notes and the unread ones"
type: reference
method: GET
path: /rest-api/user-preference/notes/unread-count.do
tag: "Users"
---

# Count my notes and the unread ones

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

How many notes the network left for the signed-in user (total) and how many of them are unread (unread). The Notes tab shows once total is above 0, and carries unread on its badge. A note is unread until the user marks it as read, and again after the network changes its title or text. Requires the NOTES_TAB_VISIBLE permission.

## Responses

- `200` — {success, unread, total}
- `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/unread-count.do' \
  --header 'X-Api-Key: YOUR_API_KEY'
```

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