---
title: "List operator alerts, paged"
method: GET
path: "/api/operator-alerts/page"
tags: ["operator-alerts"]
---

# List operator alerts, paged

`GET /api/operator-alerts/page`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/operator-alerts/page`
- Auth: HTTP bearer

One page of the operator's alerts, cursor-based

## Query parameters

- `operator_id` string, nullable
- `status` string, nullable
- `type` string[], nullable: Alert type codes to include; repeat for several. Omit for all.
- `limit` integer: Rows per page
- `cursor` string, nullable: Opaque cursor from a previous page

## Response `200`

Successful Response

- OperatorAlertPageResponse: One page of the operator's alert feed
  - `items` OperatorAlertResponse[]
    - `id` string, uuid, nullable: Alert UUID
    - `operator_id` string, uuid, nullable: Operator UUID
    - `operator_name` string, nullable: The expert's full name; filled on the paged feed only.
    - `created_at` string, date-time, nullable: Creation timestamp
    - `updated_at` string, date-time, nullable: Last update timestamp
    - `status` string, nullable: Alert status
    - `type` string, nullable: Alert type
    - `title` string, nullable: Alert title
    - `description` string, nullable: Alert description
    - `metadata` union: Alert metadata JSON
      - object
      - unknown[]
        - unknown
    - `availability_progress` object, nullable: Live slot/day requirements for an open availability alert, over its own two-week window.
    - `trend_management` SuperviseeTrendManagement: Priority, deadline and hold of a gestisci_andamento_supervisionato avviso.
      - `supervised_operator_id` string, uuid, required
      - `supervisee_name` string, nullable
      - `priority` integer, required: 1 = Rischio (due in two weeks), 2 = Attenzione (due in a month)
      - `status` string, required: risk or attention
      - `criteria` SuperviseeTrendCriterion[]
        - `key` string, required
        - `label` string, required
      - `due_at` string, date-time, required
      - `is_overdue` boolean
      - `closed_reason` string, nullable: handled, superseded or no_longer_due once closed
      - `suspension` SuperviseeTrendSuspension: The hold on an avviso: why, who set it, and how far the wait has come.
        - `id` string, uuid, required
        - `reason` 'supervisione' | 'feedback_supervisionato' | 'mini_equipe' | 'altro', required: Why a supervisor put a gestisci_andamento_supervisionato alert on hold.
        - `note` string, nullable
        - `suspended_at` string, date-time, required
        - `suspended_by_name` string, nullable
        - `progress` SuperviseeTrendProgress, required: Where the event a hold waits for stands; `label` is ready to show.
          - `kind` string, required: programmata, svolta, da_programmare or in_attesa
          - `label` string, required
          - `at` string, date-time, nullable
    - `closed_at` string, date-time, nullable: Close timestamp
    - `duration_hours` integer, nullable: Alert duration in hours
    - `is_blocking` boolean: Whether this alert can block portal access once its grace period elapses
    - `is_currently_blocking` boolean, required: Whether this alert is blocking access right now (grace period considered)
  - `next_cursor` string, nullable: Pass back as `cursor` to fetch the following page; null at the end.
  - `has_more` boolean: Whether another page exists

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `12d5032b075e`: 1 info
  - added the optional property `items/items/operator_name` to the response with the `200` status
- **2026-10-06** `4d74c6bc8ec1`: 1 info
  - added the optional property `items/items/trend_management` to the response with the `200` status
- **2026-09-15** `ab501b8b91e7`: 1 info
  - added the optional property `items/items/availability_progress` to the response with the `200` status
- **2026-09-11** `6afa01417695`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/operator-alerts/page/get.md)

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corabea/apis/corabea-api/revisions/4a8dd89893b8?raw)