# Get unread notification counts

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

Get the total unread count and category breakdown for the current user.

```text
GET https://billing.moi.matrixorigin.cn/api/v1/taas/notifications/unread-count
```

## Before you begin

Prepare a personal access token. For creation and management, see [Manage personal access tokens](../../../../../guides/billing/credentials.md#personal-access-token).

Results are scoped to data accessible to the current user.

## Request example

Replace `$MOI_PERSONAL_ACCESS_TOKEN` in the example with your personal access token.

```bash
curl --get "https://billing.moi.matrixorigin.cn/api/v1/taas/notifications/unread-count" \
  -H "X-API-Key: $MOI_PERSONAL_ACCESS_TOKEN"
```

## Successful response

Returns HTTP `200` with the unread notification total and categorized counts.

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} Response example

```json
{
  "total": 0,
  "by_category": {},
  "by_priority": {}
}
```

:::::
:::::{tab-item} Fields

| Field | Type | Description |
| --- | --- | --- |
| `total` | integer | Total unread notifications. |
| `by_category` | object | Unread counts keyed by notification category, with integer values. |
| `by_priority` | object | Unread counts keyed by priority, with integer values. |

:::::
::::::
:::::::