> ## Documentation Index
> Fetch the complete documentation index at: https://docs.signa.so/llms.txt
> Use this file to discover all available pages before exploring further.
# List Alerts
> List alerts for the calling org with cursor pagination
## Overview
Returns alerts produced by any of the org's watches. Alerts are
**immutable** -- there is no `PATCH` or batch state operation. For polling
clients, the recommended pattern is:
1. Pull pages (newest first) until you encounter an `id` you've already
processed.
2. Persist alert IDs in your own store as the system of record for "open
work" / "acknowledged."
Required scope: `portfolios:manage`.
## Query Parameters
Page size (1--100).
Opaque cursor from the previous response.
Filter by `normal`, `high`, or `critical`.
Filter by `trademark.created`, `trademark.updated`, or `trademark.status_changed`.
`all` (default) returns alerts from every evaluation epoch; `current` returns only alerts emitted under each watch's current query revision.
The legacy `?after=` and `?after_seq=` parameters are explicitly rejected
with `400`. Migrate to opaque `cursor` pagination.
## Response
Always `"list"`.
Array of `Alert` objects.
Alert ID (`alt_*`).
Always `"alert"`.
Source watch (`wat_*`).
Snapshot of watch name at evaluation time.
Matched trademark (`tm_*`).
Trigger event type.
Mark version snapshot.
Computed action deadline (ISO).
One of `open`, `closing_soon`, `critical`, `closed`.
`normal`, `high`, or `critical`.
ISO timestamp.
Whether more pages exist.
Cursor envelope.
Request identifier.
```bash cURL theme={null}
curl "https://api.signa.so/v1/alerts?severity=critical&limit=50" \
-H "Authorization: Bearer $SIGNA_API_KEY"
```
```ts TypeScript theme={null}
const alerts = await signa.alerts.list({ severity: 'critical', limit: 50 });
for await (const a of alerts) {
if (a.opposition_window_status === 'critical') escalate(a);
}
```