Skip to main content
GET
Get unread chats, messages, and notifications count
Required scope
  • read:chat — Read chat conversations, messages, and chat-related data. This includes viewing chat lists and message history.

Authorizations

Authorization
string
header
required

OAuth 2.0 access token, presented as a JWT bearer token in the Authorization header. Obtain a token via the authorization-code flow; the scopes granted to the token determine which operations it may call.

Headers

X-Fanvue-API-Version
string
default:2025-06-26
required

API version to use for the request

Example:

"2025-06-26"

Response

Unread counts retrieved successfully

unreadChatsCount
number
required

Number of conversations that are unread: those with unread messages plus those manually marked unread via PATCH /chats/{userUuid}. Use this for unread badges.

unreadMessagesCount
number
required

Total number of unread messages across all chats. A chat manually marked unread adds 0 here, as it has no unread message; it is counted in unreadChatsCount instead.

unreadNotifications
object
required

Counts of unread notifications by type