---
id: communications-notification-list
title: List notifications
description: >-
  Lists your organization's announcements and personal notifications, newest
  first, as the **Announcements** page shows them.
sidebar_label: List notifications
hide_title: true
hide_table_of_contents: true
api: >-
  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
sidebar_class_name: get api-method
info_path: docs/api/communications
custom_edit_url: null
canonical: 'https://docs.nullplatform.com/docs/api/communications-notification-list'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List notifications"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/communications/notification/manage"}
  context={"endpoint"}
>

</MethodEndpoint>

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

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"kind","required":false,"schema":{"type":"string","enum":["personal","broadcast"]},"description":"Only notifications of this kind. Use `broadcast` for announcements.","example":"broadcast"},{"in":"query","name":"offset","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"How many notifications to skip."},{"in":"query","name":"limit","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"description":"How many notifications to return, up to 100."}]}
>

</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"A page of notifications.","content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"title":"Notification","type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The ID of the notification.","example":"6f1c2b9e-3a41-4f0e-9d55-2b7c1e0a9f13"},"organization_id":{"type":"integer","description":"Your organization's ID.","example":1},"kind":{"type":"string","enum":["broadcast","personal"],"example":"broadcast"},"category":{"type":"string","example":"platform.maintenance"},"severity":{"type":"string","enum":["informational","maintenance","degraded","outage"],"example":"maintenance"},"status":{"type":"string","enum":["open","closed"],"example":"open"},"nrn":{"type":"string","example":"organization=1"},"title":{"type":"string","example":"Scheduled maintenance on Saturday"},"body":{"type":"string","nullable":true},"audience":{"type":"object","nullable":true},"surfaces":{"type":"array","example":[{"type":"banner","sections":["development"],"dismissible":true}]},"places":{"type":"array"},"cta":{"type":"object","nullable":true},"media":{"type":"object","nullable":true},"key":{"type":"string","nullable":true},"group_key":{"type":"string","nullable":true},"publisher":{"type":"string","enum":["nullplatform","organization"],"description":"`organization` for your organization's notifications, and `nullplatform` for the ones nullplatform sends your organization. Only the `status` of a `nullplatform` one can change.","example":"organization"},"publish_at":{"type":"string","format":"date-time","nullable":true},"expires_at":{"type":"string","format":"date-time","nullable":true},"closed_at":{"type":"string","format":"date-time","nullable":true},"closed_by":{"type":"integer","nullable":true},"created_by":{"type":"integer","description":"The ID of the user who created it.","example":12345},"created_at":{"type":"string","format":"date-time","example":"2026-10-27T14:03:11.000Z"},"updated_at":{"type":"string","format":"date-time","example":"2026-10-27T14:03:11.000Z"}}}},"pagination":{"type":"object","properties":{"offset":{"type":"integer","example":0},"limit":{"type":"integer","example":25},"total":{"type":"integer","description":"How many notifications match, across every page.","example":14}}}}}}}},"4XX":{"description":"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).","content":{"application/problem+json":{"schema":{"type":"object","description":"Describes what went wrong, following the RFC 9457 problem details format.","required":["type","title","status"],"properties":{"type":{"type":"string","description":"A URI that identifies the kind of problem. It's an identifier, not a link, and it's the same every time this problem occurs.","example":"urn:nullplatform:error:routes-helper:invalid-params"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","example":"There are invalid parameters on the request"},"status":{"type":"integer","description":"The HTTP status code of the response.","example":400},"code":{"type":"string","description":"A stable, machine-readable error code. Use it to handle specific errors in your integrations.","example":"ROUTES_HELPER.INVALID_PARAMS"},"detail":{"type":"string","nullable":true,"description":"More information about what went wrong in this request, when available.","example":null},"errors":{"type":"array","description":"One entry per invalid field or parameter. Only present on validation errors.","items":{"type":"object","properties":{"field":{"type":"string","description":"The name of the invalid field or parameter.","example":"application_id"},"in":{"type":"string","description":"Where the field was sent: `body`, `query`, or `params` (path parameters).","example":"query"},"issue":{"type":"string","description":"What's wrong with the field, such as `required` or `invalid`.","example":"invalid"},"value":{"description":"The value that was sent, when relevant.","example":"not-a-number"},"message":{"type":"string","description":"A human-readable explanation of the issue."}}}},"message":{"type":"string","deprecated":true,"description":"Same value as `title`, kept for backward compatibility. Use `title` or `code` instead.","example":"There are invalid parameters on the request"},"traceId":{"type":"string","description":"An identifier for this request, when available. Include it when you contact nullplatform support."}}}}}},"5XX":{"description":"Something went wrong on nullplatform's side. The body is a problem details object (RFC 9457).","content":{"application/problem+json":{"schema":{"type":"object","description":"Describes what went wrong, following the RFC 9457 problem details format.","required":["type","title","status"],"properties":{"type":{"type":"string","description":"A URI that identifies the kind of problem. It's an identifier, not a link, and it's the same every time this problem occurs.","example":"about:blank"},"title":{"type":"string","description":"A short, human-readable summary of the problem.","example":"Oops.. there was an internal error"},"status":{"type":"integer","description":"The HTTP status code of the response.","example":500},"code":{"type":"string","description":"A stable, machine-readable error code. Use it to handle specific errors in your integrations."},"detail":{"type":"string","nullable":true,"description":"More information about what went wrong in this request, when available.","example":null},"message":{"type":"string","deprecated":true,"description":"Same value as `title`, kept for backward compatibility. Use `title` or `code` instead.","example":"Oops.. there was an internal error"},"traceId":{"type":"string","description":"An identifier for this request, when available. Include it when you contact nullplatform support."}}}}}}}}
>

</StatusCodes>