---
title: "Get all notifications for the current user"
method: GET
path: "/notifications"
tags: ["subscriptions"]
---

# Get all notifications for the current user

`GET /notifications`

Returns an array with all notifications for the current user. Notifications about a project the current user can no longer read are omitted; the filtering happens in the query, so paging and the `x-pagination-*` headers all describe the visible notifications only.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

The notifications

- NotificationsDatabaseNotification[]
  - `created` string — A timestamp when this notification was created. You cannot change this value.
  - `id` integer — The unique, numeric id of this notification.
  - `name` string — The name of the notification
  - `notification` unknown
  - `read_at` string — When this notification is marked as read, this will be updated with the current timestamp.

## Other responses

- `403` — Link shares cannot have notifications.
- `500` — Internal error

---

[API](https://skmtc.net/go-vikunja/apis/vikunja-api.md) · [All operations](https://skmtc.net/go-vikunja/apis/vikunja-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/go-vikunja/vikunja-api/revisions/feb3f68bbdf1/schema)