Get unread notification counts¶

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

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.

Results are scoped to data accessible to the current user.

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

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

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

Response example

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

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.

Last updated on Sep 15, 2026