---
title: "getNotificationsV2"
method: GET
path: "/v2/notification/notifications"
tags: ["Notification"]
---

# getNotificationsV2

`GET /v2/notification/notifications`

Get notifications items. These items may eventually contain entities within their payload, which can be hydrated by the client if desired by calling the Entity API directly.

## Query parameters

- `cursor` string
- `after_id` integer
- `limit` integer

## Response `200`

Success

- object
  - `cursor` string — Base64 encoded cursor to be used for pagination
  - `total` integer
  - `total_unread` integer
  - `results` NotificationItem[]
    - `id` number
    - `notification_id` number
    - `timestamp` string, date-time
    - `read_state` boolean
    - `type` string, required — Type of notification
    - `redirect_url` string — Redirect url
    - `organization_id` string — Organization Id
    - `title` object, required
      - `en` string — Title for notification. Supports handlebars syntax.
      - `de` string — Title for notification. Supports handlebars syntax.
    - `message` object, required
      - `en` string — Message for notification. Supports handlebars syntax.
      - `de` string — Message for notification. Supports handlebars syntax.
    - `payload` object
    - `caller` NotificationCallerContext
      - `EpilotAuth` object
        - `token` object
          - `sub` string
          - `email` string
          - `cognito:username` string
          - `custom:ivy_user_id` string
    - `operations` EntityOperation[]
      - `entity` string, uuid, required
      - `operation` string
      - `params` object
        - `id` string, uuid
        - `slug` string — URL-friendly identifier for the entity schema
      - `payload` object
    - `force_notify_users` object
    - `allowed_channels` string[] — Optional delivery-channel ceiling. When present, delivery is restricted to the intersection of this set and each recipient's own notification preferences — it can only NARROW delivery, never force a channel on. Absent means no restriction (recipient preferences and per-type defaults apply as before). An empty array suppresses all channels.

## Changes

- **2026-07-21** `38fa1829759b` — 1 info
  - added the optional property `results/items/allOf[#/components/schemas/NotificationBase]/allowed_channels` to the response with the `200` status

[Change history](https://skmtc.dev/epilot/apis/notification-api/changes/v2/notification/notifications/get.md)

---

[API](https://skmtc.dev/epilot/apis/notification-api.md) · [All operations](https://skmtc.dev/epilot/apis/notification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epilot/notification-api/revisions/0f041a715e69/schema)