---
title: "List notifications"
method: GET
path: "/communications/notification/manage"
tags: ["Announcements"]
---

# List notifications

`GET /communications/notification/manage`

## Request

- Base URL: `https://api.nullplatform.com`
- URL: `https://api.nullplatform.com/communications/notification/manage`
- Auth: HTTP bearer

Lists your organization's announcements and personal notifications, newest first, as the **Announcements** page shows them.

## Query parameters

- `kind` 'personal' | 'broadcast'
- `offset` integer
- `limit` integer

## Response `200`

A page of notifications.

- object
  - `results` Notification[]
    - `id` string, uuid: The ID of the notification.
    - `organization_id` integer: Your organization's ID.
    - `kind` 'broadcast' | 'personal'
    - `category` string
    - `severity` 'informational' | 'maintenance' | 'degraded' | 'outage'
    - `status` 'open' | 'closed'
    - `nrn` string
    - `title` string
    - `body` string, nullable
    - `audience` object, nullable
    - `surfaces` unknown[]
      - unknown
    - `places` unknown[]
      - unknown
    - `cta` object, nullable
    - `media` object, nullable
    - `key` string, nullable
    - `group_key` string, nullable
    - `publisher` 'nullplatform' | 'organization': `organization` for your organization's notifications, and `nullplatform` for the ones nullplatform sends your organization. Only the `status` of a `nullplatform` one can change.
    - `publish_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `closed_at` string, date-time, nullable
    - `closed_by` integer, nullable
    - `created_by` integer: The ID of the user who created it.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `pagination` object
    - `offset` integer
    - `limit` integer
    - `total` integer: How many notifications match, across every page.

## Other responses

- `4XX`: The request couldn't be processed. For example, a parameter is invalid, the resource doesn't exist, or you don't have permission. The body is a problem details object (RFC 9457).
- `5XX`: Something went wrong on nullplatform's side. The body is a problem details object (RFC 9457).

## Changes

- **2026-10-27** `c0f507ec6087`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nullplatform/apis/nullplatform-api/changes/communications/notification/manage/get.md)

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) - [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nullplatform/apis/nullplatform-api/revisions/d3f66bc633d4?raw)