---
title: "List Unread Notifications"
method: GET
path: "/api/notifications/in-app/deployments/{deploymentId}"
tags: ["NotificationsService"]
---

# List Unread Notifications

`GET /api/notifications/in-app/deployments/{deploymentId}`

Returns a paginated list of unread notifications for a particular viewer

## Path parameters

- `deploymentId` string, required

## Query parameters

- `cursor` string
- `limit` string

## Response `200`

OK

- ProtosNotificationsV1GetNotificationsResponse — NOTE: As mentioned on the RPC, this is non-conforming.
  - `notifications` ProtosNotificationsV1Notification[]
    - `id` string
    - `title` string
    - `description` string
    - `severity` 'SEVERITY_INFO' | 'SEVERITY_WARNING' | 'SEVERITY_ERROR', enum — | value | description | |-------|---------------| | SEVERITY_INFO | | | SEVERITY_WARNING | | | SEVERITY_ERROR | |
    - `status` 'STATUS_DELIVERED' | 'STATUS_SEEN' | 'STATUS_ARCHIVED', enum — | value | description | |-------|---------------| | STATUS_DELIVERED | | | STATUS_SEEN | | | STATUS_ARCHIVED | |
    - `adminOnly` boolean
    - `createdAt` string
    - `link` string
    - `isExternalLink` boolean
    - `linkText` string
  - `cursor` string

---

[API](https://skmtc.net/semgrep/apis/semgrep-web-app.md) · [All operations](https://skmtc.net/semgrep/apis/semgrep-web-app/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/semgrep/semgrep-web-app/versions/6483eeecd582/schema)