---
id: communications-notification-read
title: Read a notification
description: Returns one of your organization's notifications or announcements.
sidebar_label: Read a notification
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-read'
---
<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Read a notification"}
>
</Heading>

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

</MethodEndpoint>

Returns one of your organization's notifications or announcements.

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"},"description":"The ID of the notification, as returned when it was created or listed.","example":"6f1c2b9e-3a41-4f0e-9d55-2b7c1e0a9f13"}]}
>

</ParamsDetails>

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

</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The requested notification.","content":{"application/json":{"schema":{"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"}}}}}},"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>