---
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

---

[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/f77962e4fd30/schema)