---
title: "Get notification summary"
method: GET
path: "/notifications/v1/user-notifications:summary"
tags: ["User Notifications (notifications/v1)"]
---

# Get notification summary

`GET /notifications/v1/user-notifications:summary`

[![Early Access](https://img.shields.io/badge/Lifecycle%20Stage-Early%20Access-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) [![Request Access To User Notifications API v1](https://img.shields.io/badge/-Request%20Access%20To%20User%20Notifications%20API%20v1-%23bc8540)](mailto:ccloud-api-access+notifications-v1-early-access@confluent.io?subject=Request%20to%20join%20notifications/v1%20API%20Early%20Access&body=I%E2%80%99d%20like%20to%20join%20the%20Confluent%20Cloud%20API%20Early%20Access%20for%20notifications/v1%20to%20provide%20early%20feedback%21%20My%20Cloud%20Organization%20ID%20is%20%3Cretrieve%20from%20https%3A//confluent.cloud/settings/billing/payment%3E.)

Returns the authenticated user's total unread notification count along with
a breakdown by severity.

## Response `200`

Notification summary.

- NotificationsV1Summary — Summary of unread notifications for the authenticated user.
  - `api_version` 'notifications/v1', required — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'Summary', required — Kind defines the object this REST resource represents.
  - `unread_count` integer, required — Total number of unread notifications.
  - `severities` object[], required — Breakdown of unread notifications by severity level. One entry per severity present in the user's unread set; severities with a zero count may be omitted. New severity values may be added over time without a breaking change to this schema.
    - `severity` string, required — The severity level this entry counts.
    - `count` integer, required — Number of unread notifications at this severity.

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)