---
title: "getNotification"
method: GET
path: "/v1/notification/notifications/{id}"
tags: ["Notification"]
---

# getNotification

`GET /v1/notification/notifications/{id}`

Get the details of a single notification.

## Path parameters

- `id` number, required

## Response `200`

Success

- 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 `allOf[#/components/schemas/NotificationBase]/allowed_channels` to the response with the `200` status

[Change history](https://skmtc.dev/epilot/apis/notification-api/changes/v1/notification/notifications/:id/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)
