List notifications - Unstructured

curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/notifications?limit=50&unread_only=false" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import ListNotificationsApiV1NotificationsGetRequest

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

response = client.notifications.list_notifications(
    request=ListNotificationsApiV1NotificationsGetRequest(
        limit=50,
        unread_only=False,
    )
)
print(response)

import asyncio
import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import ListNotificationsApiV1NotificationsGetRequest

async def list_notifications():
    client = UnstructuredClient(
        api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
        server_url=os.getenv("UNSTRUCTURED_API_URL"),
    )
    response = await client.notifications.list_notifications_async(
        request=ListNotificationsApiV1NotificationsGetRequest(
            limit=50,
            unread_only=False,
        )
    )
    print(response)

asyncio.run(list_notifications())

{
  "events": [
    {
      "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
    }
  ],
  "next_cursor": null
}

GET

api

notifications

curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/notifications?limit=50&unread_only=false" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import ListNotificationsApiV1NotificationsGetRequest

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

response = client.notifications.list_notifications(
    request=ListNotificationsApiV1NotificationsGetRequest(
        limit=50,
        unread_only=False,
    )
)
print(response)

import asyncio
import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import ListNotificationsApiV1NotificationsGetRequest

async def list_notifications():
    client = UnstructuredClient(
        api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
        server_url=os.getenv("UNSTRUCTURED_API_URL"),
    )
    response = await client.notifications.list_notifications_async(
        request=ListNotificationsApiV1NotificationsGetRequest(
            limit=50,
            unread_only=False,
        )
    )
    print(response)

asyncio.run(list_notifications())

{
  "events": [
    {
      "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
    }
  ],
  "next_cursor": null
}

Query parameters

workflow_id

string

Filter by workflow ID.

event_types

string

Comma-separated list of event types to filter by (e.g., job.completed,job.failed).

since

string

Return events created after this ISO 8601 timestamp.

limit

integer

Maximum number of events to return. Must be between 1 and 100. Default: 50.

cursor

string

Pagination cursor from a previous response.

unread_only

boolean

If true, return only unread events for the current user. Default: false.

Response

events

array

required

List of notification event objects.

next_cursor

string

Cursor for the next page of results. null if no further pages exist.

curl --request GET \
  --url "${UNSTRUCTURED_API_URL}/api/v1/notifications?limit=50&unread_only=false" \
  --header "unstructured-api-key: ${UNSTRUCTURED_API_KEY}"

import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import ListNotificationsApiV1NotificationsGetRequest

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

response = client.notifications.list_notifications(
    request=ListNotificationsApiV1NotificationsGetRequest(
        limit=50,
        unread_only=False,
    )
)
print(response)

import asyncio
import os
from unstructured_client import UnstructuredClient
from unstructured_client.models.operations import ListNotificationsApiV1NotificationsGetRequest

async def list_notifications():
    client = UnstructuredClient(
        api_key_auth=os.getenv("UNSTRUCTURED_API_KEY"),
        server_url=os.getenv("UNSTRUCTURED_API_URL"),
    )
    response = await client.notifications.list_notifications_async(
        request=ListNotificationsApiV1NotificationsGetRequest(
            limit=50,
            unread_only=False,
        )
    )
    print(response)

asyncio.run(list_notifications())

{
  "events": [
    {
      "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
    }
  ],
  "next_cursor": null
}

Notification endpoints Get notification

​Query parameters

​Response

Query parameters

Response