GET `/notifications/unread`

Get a list of all unread notifications for the current user. Reference: CAN-SPAM Act (15 U.S.C. §7701) — Commercial Email Compliance.

Notification Service `bearerAuth` application/json

Responses

Status	Description	Schema
200	Unread notification list	`dto.NotificationListResponse`
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`

Field	Type	Required	Description
`code`	`integer`	No
`items`	array of See `dto.NotificationResponse`	No	Unified use of items
`message`	`string`	No
`pagination`	`object`	No	Pagination info (nested object)
`timestamp`	`string`	No
`total`	`integer`	No	Total count (flattened for direct reading)

Notification info response

Field	Type	Required	Example	Description
`action_url`	`string`	No	`/security`	Action link
`content`	`string`	No	`Your account has been successfully upgraded`	Content
`created_at`	`string`	No	`2026-04-15T10:30:00Z`	Creation time
`event_type`	`string`	No	`status.incident.created`
`id`	`string`	No	`ntf_abc123`	Notification ID
`is_read`	`boolean`	No	`False`	Is read
`metadata`	`string`	No	`{"ip":"1.2.3.4"}`	Metadata JSON
`priority`	`string`	No	`medium`	Priority
`read_at`	`string`	No	`2026-04-15T11:00:00Z`	Read time
`tenant_id`	`string`	No	`tnt_xyz789`	Tenant ID
`title`	`string`	No	`System notification`	Title
`type`	`string`	No	`system`	Type
`user_id`	`string`	No	`usr_abc123`	User ID

Field	Type	Required	Description
`has_next`	`boolean`	No	HasNext indicates whether there is a next page
`has_prev`	`boolean`	No	HasPrev indicates whether there is a previous page
`page`	`integer`	No	Page is the current page number (1-based)
`page_size`	`integer`	No	PageSize is the number of items per page
`total`	`integer`	No	Total is the total number of items across all pages
`total_pages`	`integer`	No	TotalPages is the total number of pages

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No