---
title: "List Notifications"
method: GET
path: "/api/v1/notifications"
tags: ["notifications"]
---

# List Notifications

`GET /api/v1/notifications`

List notification events for the authenticated user.

Returns persisted notification events enriched with per-user read status.
Each notification represents a platform event (e.g., job.completed) with
an `is_read` flag indicating whether the current user has marked it as read.

Ordered by created_at DESC with cursor-based pagination.

Args:
    workflow_id: Filter by workflow ID
    event_types: Comma-separated event types (e.g., "job.completed,job.failed")
    since: Filter events created after this ISO 8601 timestamp
    limit: Max events to return (1-100, default 50)
    cursor: Pagination cursor from previous response
    unread_only: Filter to unread events only for current user

## Query parameters

- `workflow_id` string, uuid, nullable
- `event_types` string, nullable
- `since` string, date-time, nullable
- `limit` integer
- `cursor` string, nullable
- `unread_only` boolean

## Headers

- `unstructured-api-key` string, nullable

## Response `200`

Successful Response

- NotificationListResponse — Paginated notification list response.
  - `events` NotificationResponse[], required — List of notification events
    - `id` string, uuid, required — Notification event UUID
    - `event_type` string, required — Event type (e.g., job.completed)
    - `workflow_id` string, uuid, nullable — Workflow scope (null = account-level)
    - `payload` object, required — Event payload data
    - `created_at` string, date-time, required — Event creation timestamp
    - `is_read` boolean — Read status for current user
  - `next_cursor` string, nullable — Cursor for next page (null if no more)

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/unstructuredapp/apis/platform-api.md) · [All operations](https://skmtc.net/unstructuredapp/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstructuredapp/platform-api/versions/41676641a27c/schema)