GET /notifications/unread-count

Get the count of unread notifications and the time of the last notification for the current user. Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Responses

Status	Description	Schema
200	Unread count	dto.UnreadCountDetailResponse
400	Invalid request parameters	gitee_com_linmes_authms_base_dto.SimpleResponse
401	Unauthenticated	gitee_com_linmes_authms_base_dto.SimpleResponse
403	Insufficient permissions	gitee_com_linmes_authms_base_dto.SimpleResponse
404	Resource not found	gitee_com_linmes_authms_base_dto.SimpleResponse
500	Internal server error	gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.UnreadCountDetailResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
data	dto.UnreadCountResponse	No
message	string	No
timestamp	string	No

dto.UnreadCountResponse

User unread notification count

Field	Type	Required	Example	Constraints	Description
last_notification_at	string	No	2026-04-15T10:30:00Z		Last notification
unread_count	integer	No	5		Unread count
user_id	string	No	usr_abc123		User ID

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required	Example	Constraints	Description
code	integer	No
message	string	No
timestamp	string	No