---
title: "List notifications"
method: GET
path: "/notification"
tags: ["Notifications"]
---

# List notifications

`GET /notification`

Get every notification for the current user, read and unread.

## Response `200`

List of notifications

- Notification[]
  - `id` string, required
  - `userId` string, required
  - `title` string, nullable, required
  - `content` string, nullable, required — Free-text body. Null for generated notifications, whose text the client renders from type and eventData.
  - `type` string, required — One of: info, task_created, workspace_created, task_status_changed, task_assignee_changed, time_entry_created, due_date_reminder, task_overdue, task_mention, task_comment.
  - `eventData` unknown
  - `isRead` boolean, nullable, required
  - `resourceId` string, nullable, required — The id of the task or workspace the notification points at.
  - `resourceType` string, nullable, required — `task` or `workspace`.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `401` — Missing or invalid credentials

## Changes

- **2026-08-24** `08bbb5bedb5d` — 5 breaking, 15 info
  - the response property `items/isRead` became nullable for the status `200`
  - the response property `items/resourceId` became nullable for the status `200`
  - the response property `items/resourceType` became nullable for the status `200`
  - the response property `items/eventData` became optional for the status `200`
  - …16 more
- **2026-07-11** `32cece1ebe43` — 4 breaking, 3 warning, 2 info
  - the response property `items/title` became nullable for the status `200`
  - the `items/createdAt` response's property type/format changed from ``/`` to `string`/`date-time` for status `200`
  - the `items/resourceType` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - the `items/type` response's property type/format changed from ``/`` to `string`/`` for status `200`
  - …5 more
- **2026-03-05** `c45ef22a736c` — 1 breaking, 1 info
  - the response property `items/content` became nullable for the status `200`
  - response property `items/content` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/usekaneo/apis/kaneo-api/changes/notification/get.md)

---

[API](https://skmtc.dev/usekaneo/apis/kaneo-api.md) · [All operations](https://skmtc.dev/usekaneo/apis/kaneo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/usekaneo/kaneo-api/revisions/9d1da42c10ce/schema)