Fetch user notifications

Returns paginated notifications for the authenticated user - includes their own targeted notifications plus all generic broadcast notifications. Calling this endpoint marks ALL of the user's notifications as read, so returned items always have is_read=true.

Request: Bearer token

Query params: page_number (default 1)

Success: 200 - data.notifications[] (each: id, title, body, image_url, is_read, send_status, sent_on, created_at) plus data.total, data.offset, data.limit.

Errors: 401 - invalid/expired token

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "notifications": [
            {
                "id": "Notif-83421",
                "title": "Your horoscope is ready",
                "body": "Check what the stars say today.",
                "is_read": true,
                "send_status": "sent",
                "sent_on": "2026-05-20T10:30:00Z",
                "created_at": "2026-05-20T10:30:00Z"
            }
        ],
        "total": 12,
        "offset": 0,
        "limit": 10
    }
}

🟠401Unauthorized

🟠422Parameter Error

Fetch user notifications

Request

Request Code Samples

Responses