Skip to main content
GET
/
notifications
List notifications
curl --request GET \
  --url https://api.wacht.dev/notifications \
  --cookie session_id=
{
  "data": [
    {
      "id": "123456789012345678",
      "user_id": "777777777777777777",
      "type": "organization.invitation",
      "title": "New organization invitation",
      "body": "You have been invited to join Acme Corp",
      "scope": "organization",
      "scope_id": "999999999999999999",
      "action_url": "https://app.wacht.dev/organizations/999",
      "read": false,
      "starred": false,
      "archived": false,
      "metadata": {},
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z"
    }
  ],
  "has_more": false,
  "limit": 20,
  "offset": 0
}

Authorizations

session_id
string
cookie
required

Session-based authentication using cookies

Query Parameters

limit
integer
default:20
Required range: 1 <= x <= 100
offset
integer
default:0
Required range: x >= 0
scope
string

Filter by scope

Example:

"organization"

scope_id
string<uint64>

Filter by scope ID

archived
boolean

Filter by archived status

Response

Notifications retrieved successfully

data
object[]
has_more
boolean
Example:

false

limit
integer
Example:

20

offset
integer
Example:

0