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

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

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.

​
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 --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/notifications/a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

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