---
id: notification-event-read
title: "Read an event"
description: "Retrieves a single notification event by its ID."
sidebar_label: "Read an event"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/notification
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Read an event"}
>
</Heading>

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



Retrieves a single notification event by its ID.


<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 notification ID, in UUID format.","example":"1180cd02-1c36-4274-8e7a-4483b87e8f2e"},{"in":"query","name":"include_results","required":false,"schema":{"type":"boolean","default":false},"description":"Whether to include `results` in the response.","example":false},{"in":"query","name":"include_context","required":false,"schema":{"type":"boolean","default":false},"description":"Whether to include `context` in the response.\n> ℹ️ **Note:** You need a **secops** role to use this parameter.\n","example":false}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["id","nrn","source","event","created_at","status","results","context"],"properties":{"id":{"type":"string","format":"uuid","description":"A system-wide unique ID for the notification, in UUID format.","example":"1180cd02-1c36-4274-8e7a-4483b87e8f2e"},"source":{"type":"array","description":"A list of sources that the notification channel will listen to. Each source represents a specific type of notification.","example":["approval"],"items":{"type":"string","enum":["approval","service","audit","alert","entity","telemetry","parameters"]},"title":"source"},"action":{"type":"string","description":"The name of the action originated by the source.","enum":["action:instance_kill:create","application:create","audit:log","deployment:create","deployment:write","deployment_group:create","grant:create","instance:data","log:read","metric:data","metric:list","parameter:delete","parameter:notify","parameter:read-secrets","parameter:retrieve","parameter:store","scope:create","scope:delete","scope:recreate","scope:stop","scope:write","service:action:create","target_group:create"],"example":"deployment:create","title":"action"},"status":{"type":"string","description":"The status of the notification.","enum":["success","fail"],"example":"success"},"created_at":{"type":"string","format":"date-time","description":"The ISO 8601 UTC timestamp for this notification.","example":"2024-02-19T12:34:56Z"},"updated_at":{"type":"string","format":"date-time","description":"The ISO 8601 UTC timestamp for the last update to this notification.","example":"2024-02-19T12:34:56Z"},"tags":{"type":"object","description":"A key-value map of tags associated with the notification.","example":{"approval_id":1234,"scope_slug":"development-uk-123"}},"results":{"type":"array","nullable":true,"description":"An array of results for each channel the notification was sent to.","example":[{"my-slack-channel":{"ok":true,"id":"123456"}}]},"context":{"type":"object","description":"An object containing additional context for the notification."}},"title":"notification"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>