Fetch user notifications

GET

https://uat-api.hastaai.in/api/v1/notifications

notifications

Last modified:2026-08-19 13:41:54

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

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://uat-api.hastaai.in/api/v1/notifications?page_number=undefined' \
--header 'Authorization: Bearer <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.",
                "deep_link": "action://horoscope",
                "is_read": false,
                "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

Modified at 2026-08-19 13:41:54

Send a test notification (deep link redirect check)

Get unread notification count