Get unread notification count

GET

/api/v1/notifications/unread-count

notifications

Last modified:2026-06-04 22:55:16

Returns the number of unread notifications for the authenticated user (their targeted notifications plus generic broadcasts not yet read). Use for the notification badge.

Request: Bearer token

Body: none

Success: 200 - { unread_count: <int> }

Errors: 401 - invalid token | 404 - user not found

Request

None

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "unread_count": 5
    }
}

🟠401Unauthorized

🟠404Record Not Found

Modified at 2026-06-04 22:55:16

Fetch user notifications

Mark notification as read