List Notifications

List notifications for your organization.

Returns a paginated list of system notifications ordered by most recent first. Notifications are generated by system events such as ingestion task completion, processing failures, or webhook delivery issues.

Use Cases

  • Build a notification inbox in your application.
  • Poll for new system events (filter by status=unread).
  • Display unread notification count in your UI.
  • Filter notifications by resource type or namespace to show relevant events.

Filters

Use filter[field]=condition:value to narrow results. See Query Parameters for full syntax.

  • filter[status]=eq:unread โ€” show only unread notifications
  • filter[resource_type]=eq:asset_task โ€” filter by resource type
  • filter[namespace]=eq:ingestion โ€” filter by event namespace

Required scope: notifications:read