List notifications

GET

/notifications

Returns paginated notifications for the authenticated user, ordered by creation time (newest first). Optionally filter to show only unread notifications.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Query Params

Responses

🟢200OK

application/json

Successful response

Body

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET '/notifications?limit&offset&unreadOnly' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": [
        {
            "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
            "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
            "type": "string",
            "title": "string",
            "message": "string",
            "data": {
                "property1": "string",
                "property2": "string"
            },
            "read_at": "string",
            "created_at": "string"
        }
    ],
    "meta": {
        "count": 0,
        "hasMore": true
    }
}

Modified at 2026-02-08 16:57:15

Accept invitation

Mark all notifications as read