> ## Documentation Index
> Fetch the complete documentation index at: https://docs.unstructured.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get notification

> Get a single notification event by ID.

## Path parameters

<ParamField path="notification_id" type="string" required>
  The unique identifier of the notification event.
</ParamField>

## Response

<ResponseField name="id" type="string" required>
  Unique identifier for the notification event.
</ResponseField>

<ResponseField name="event_type" type="string" required>
  Event type (e.g., `job.completed`).
</ResponseField>

<ResponseField name="payload" type="object" required>
  Event payload data.
</ResponseField>

<ResponseField name="created_at" type="string" required>
  ISO 8601 timestamp when the event was created.
</ResponseField>

<ResponseField name="workflow_id" type="string">
  Workflow associated with this event. `null` for workspace-level events.
</ResponseField>

<ResponseField name="is_read" type="boolean">
  Whether the current user has marked this notification as read. Default: `false`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url "${UNSTRUCTURED_API_URL}/api/v1/notifications/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
    --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"
  ```

  ```python Python SDK theme={null}
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import GetNotificationApiV1NotificationsNotificationIdGetRequest

  client = UnstructuredClient(
      api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
      server_url=os.getenv("UNSTRUCTURED_API_URL"),
  )

  response = client.notifications.get_notification(
      request=GetNotificationApiV1NotificationsNotificationIdGetRequest(
          notification_id="a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
      )
  )
  print(response)
  ```

  ```python Python SDK (async) theme={null}
  import asyncio
  import os
  from unstructured_client import UnstructuredClient
  from unstructured_client.models.operations import GetNotificationApiV1NotificationsNotificationIdGetRequest

  async def get_notification():
      client = UnstructuredClient(
          api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
          server_url=os.getenv("UNSTRUCTURED_API_URL"),
      )
      response = await client.notifications.get_notification_async(
          request=GetNotificationApiV1NotificationsNotificationIdGetRequest(
              notification_id="a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
          )
      )
      print(response)

  asyncio.run(get_notification())
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "event_type": "job.completed",
    "workflow_id": "f0a1b2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "payload": {
      "job_id": "b2c3d4e5-6f7a-8b9c-0d1e-2f3a4b5c6d7e",
      "status": "COMPLETED"
    },
    "created_at": "2026-04-29T10:05:00Z",
    "is_read": false
  }
  ```
</ResponseExample>