Get notification

Get a single notification event by ID.

GET /api/v1/notifications/{notification_id}

cURL

curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/notifications/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

Response

{
  "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
}

Path parameters

notification_id · string · required

The unique identifier of the notification event.

Response

id · string · required

Unique identifier for the notification event.

event_type · string · required

Event type (e.g., job.completed).

payload · object · required

Event payload data.

created_at · string · required

ISO 8601 timestamp when the event was created.

workflow_id · string

Workflow associated with this event. null for workspace-level events.

is_read · boolean

Whether the current user has marked this notification as read. Default: false.

cURL

curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/notifications/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

Response

{
  "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
}