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

# List Notifications

`GET /notifications`

## Request

- Base URL: `https://connect.weld.app`
- URL: `https://connect.weld.app/notifications`
- Auth: API key in header `x-api-key`

List the active Notifications of the account in pages, sorted by creation date in descending order (most recent first). A Notification with `is_lock` set pauses the entity it concerns until it is removed. `QUARANTINE` Notifications carry a `quarantine_explanation` with the cause and the steps that clear it.

## Query parameters

- `starting_after` string
- `limit` integer

## Response `200`

- PagedNotificationDto
  - `has_more` boolean, required: Indicates whether there are more items to be fetched in the subsequent pages.
  - `next_cursor` string: The cursor to use in pagination. Use this value as `starting_after` to get the next page.
  - `data` NotificationDto[], required: List of Notifications
    - `id` string, required: The ID of the Notification.
    - `type` string, required: The kind of issue the Notification reports.
    - `level` 'ERROR' | 'INFO' | 'WARNING', required: The severity of the Notification.
    - `message` string, required: A short plain-text description of the issue.
    - `entity_type` 'ACCOUNT' | 'CONNECTION' | 'ELT_STREAM' | 'ELT_SYNC' | 'ORCHESTRATION' | 'OTHER' | 'REVERSE_ETL_SYNC' | 'TRANSFORM', required: The kind of resource the Notification concerns. `OTHER` covers notifications about something the API does not expose, and syncs that no longer exist.
    - `elt_stream_id` string, nullable, required: The ID of the ELT Stream the Notification concerns. Set when `entity_type` is `ELT_STREAM` and the stream still exists.
    - `elt_sync_id` string, nullable, required: The ID of the ELT Sync the Notification concerns. Set when `entity_type` is `ELT_SYNC`, and with `elt_stream_id` for `ELT_STREAM`.
    - `reverse_etl_sync_id` string, nullable, required: The ID of the Reverse ETL Sync the Notification concerns. Set when `entity_type` is `REVERSE_ETL_SYNC`.
    - `connection_id` string, nullable, required: The ID of the Connection the Notification concerns. Set when `entity_type` is `CONNECTION`.
    - `orchestration_id` string, nullable, required: The ID of the Orchestration the Notification concerns. Set when `entity_type` is `ORCHESTRATION`.
    - `transform_id` string, nullable, required: The ID of the Transform the Notification concerns. Set when `entity_type` is `TRANSFORM`.
    - `entity_name` string: A human-readable name of the entity.
    - `is_dismissable` boolean, required: Whether the Notification can be removed. Other Notifications are removed once the issue is resolved.
    - `is_lock` boolean, required: Whether the Notification pauses the entity until it is removed.
    - `created_at` string, date-time, required: The datetime the Notification was created.
    - `last_occurred_at` string, date-time, required: The datetime the issue was last reported.
    - `expires_at` string, date-time: The datetime the Notification is removed automatically, if it expires.
    - `quarantine_explanation` QuarantineExplanationDto
      - `headline` string, required: A one-line summary of why the stream is quarantined.
      - `summary` string, required: A short explanation of the failure.
      - `actions` QuarantineActionDto[], required: Steps that clear the quarantine.
        - `type` 'CHECK_SOURCE_OBJECT' | 'CHECK_SOURCE_PERMISSIONS' | 'CONTACT_SUPPORT' | 'FIX_INCREMENTAL_CONFIG' | 'RE_AUTHENTICATE' | 'REDUCE_SYNC_FREQUENCY' | 'RETRY_SYNC' | 'WAIT_FOR_WELD', required: The kind of step that clears the quarantine.
        - `detail` string, required: The specific thing to check or do.
      - `responsibility` 'CUSTOMER' | 'TRANSIENT' | 'WELD', required: Who can clear the quarantine: the customer, Weld, or time (a transient failure).
      - `generated_at` string, required: The datetime the explanation was generated.

## Changes

- **2026-10-15** `809d13cf30ec`: 1 breaking
  - the `data/items/quarantine_explanation` response's property type changed from no type to `object` for status `200`
- **2026-10-05** `d5880edf3a6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/weld/apis/weld-rest-api/changes/notifications/get.md)

---

[API](https://skmtc.dev/weld/apis/weld-rest-api.md) - [All operations](https://skmtc.dev/weld/apis/weld-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/weld/apis/weld-rest-api/revisions/0e768a2ead18?raw)