# Notifications

User notification management for retrieving, counting, and updating notification status. Notifications are generated by user interactions such as follows, mentions, reposts, and likes. Supports filtering by notification type and status (read/unread). All endpoints require authentication.

## List user's notifications

 - [GET /api/v1/notifications](https://docs.wellesley.social/openapi/notifications/paths/~1api~1v1~1notifications/get.md): Retrieves a paginated list of the authenticated user's notifications. Supports filtering by specific notification types (include or exclude) and by read/unread status. Results are ordered by creation date, most recent first. Requires authentication.

## Get notifications count

 - [GET /api/v1/notifications/count](https://docs.wellesley.social/openapi/notifications/paths/~1api~1v1~1notifications~1count/get.md): Returns the total count of the authenticated user's notifications matching the given filters. Supports the same type and status filters as the list endpoint. Useful for displaying unread badge counts. Requires authentication.

## Mark all notifications as read or unread

 - [POST /api/v1/notifications/mark-all](https://docs.wellesley.social/openapi/notifications/paths/~1api~1v1~1notifications~1mark-all/post.md): Bulk-updates the read/unread status of all notifications for the authenticated user. Returns the number of notifications that were changed. Requires authentication.

## Get notification by ID

 - [GET /api/v1/notifications/{id}](https://docs.wellesley.social/openapi/notifications/paths/~1api~1v1~1notifications~1%7Bid%7D/get.md): Retrieves a specific notification by its ID. Only returns the notification if it belongs to the authenticated user. Requires authentication.

## Mark notification as read or unread

 - [POST /api/v1/notifications/{id}/mark](https://docs.wellesley.social/openapi/notifications/paths/~1api~1v1~1notifications~1%7Bid%7D~1mark/post.md): Updates the read/unread status of a specific notification. Only the notification owner can change its status. Requires authentication.