Retrieve a paginated list of app notifications for the authenticated user, ordered by most recent first.
Query Parameters
Page number (must be a whole number >= 1)
Number of notifications to return (max: 50)
Response
Returns an array of notification objects:
Unique notification identifier
ID of the user receiving the notification
Notification type (e.g., “new-follow”, “comment-reply”)
Action associated with the notification (e.g., “open-profile”)
ID of the user who triggered the notification
Username of the initiator
URL to the initiator’s avatar image
Timestamp when notification was created
Timestamp when notification was last updated
Error Responses
Invalid Page - 400 Bad Request
{
"error": "Invalid request: 'page' must be a whole number greater than 0",
"code": "app-notification/invalid-page"
}
Invalid Limit - 400 Bad Request
{
"error": "Invalid request: limit must be a number",
"code": "app-notification/invalid-limit"
}
Server Error - 500 Internal Server Error
{
"error": "Internal server error.",
"code": "app-notification/server-error",
"details": "<Error message>"
}
Notes
- Requires authentication
- Pagination is supported via
page
and limit
query parameters
- Maximum value for
limit
is 50, default is 5
- Notifications are returned in reverse chronological order (most recent first)
- Rate limiting: 100 requests per 5 minutes