# 查询未读通知数

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

查询当前用户未读通知的总数及分类统计。

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

## 调用前准备

准备个人访问令牌。创建和管理方法参阅[创建和管理个人访问令牌](../../../../../guides/genesis/api-keys.md#创建和管理个人访问令牌)。

查询范围为当前用户有权访问的数据。

## 请求示例

将示例中的 `$MOI_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"
```

## 成功响应

返回 HTTP `200`，响应包含未读通知总数和分类统计。

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

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

:::::
:::::{tab-item} 字段说明

| 字段 | 类型 | 说明 |
| --- | --- | --- |
| `total` | integer | 未读通知总数。 |
| `by_category` | object | 按分类名称返回未读数；键为通知分类，值为整数。 |
| `by_priority` | object | 按优先级名称返回未读数；键为优先级，值为整数。 |

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