Skip to content
StraventaDocs

Get unread notification count (badge poll)

Lightweight endpoint for the badge poll — returns only the running unread count, never the full notification list.

GET
/v1/me/notifications/unread-count

Lightweight endpoint for the badge poll — returns only the running unread count, never the full notification list.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT Bearer access token. Clock skew tolerance is ±60 seconds.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/me/notifications/unread-count"
{
  "unread_count": 3
}
{
  "error": "unauthenticated",
  "message": "missing or invalid bearer token",
  "request_id": "req_01abc123"
}

Was this page helpful?