List Alerts

List alerts for the calling org with cursor pagination

GET /v1/alerts

cURL

curl "https://api.signa.so/v1/alerts?severity=critical&limit=50" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

200

{
  "object": "<string>",
  "data": [
    {
      "id": "<string>",
      "object": "<string>",
      "watch_id": "<string>",
      "watch_name": "<string>",
      "trademark_id": "<string>",
      "event_type": "<string>",
      "content_version": 123,
      "must_act_by": {},
      "opposition_window_status": {},
      "severity": "<string>",
      "created_at": "<string>"
    }
  ],
  "has_more": true,
  "pagination": {},
  "request_id": "<string>"
}

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

limit · integer · default: "20"

Page size (1—100).

cursor · string

Opaque cursor from the previous response.

severity · string

Filter by normal, high, or critical.

event_type · string

Filter by trademark.created, trademark.updated, or trademark.status_changed.

epoch · string · default: "all"

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

object · string

Always "list".

data · object[]

Array of Alert objects.

Show Alert

id · string

Alert ID (alt_*).

object · string

Always "alert".

watch_id · string

Source watch (wat_*).

watch_name · string

Snapshot of watch name at evaluation time.

trademark_id · string

Matched trademark (tm_*).

event_type · string

Trigger event type.

content_version · integer

Mark version snapshot.

must_act_by · string | null

Computed action deadline (ISO).

opposition_window_status · string | null

One of open, closing_soon, critical, closed.

severity · string

normal, high, or critical.

created_at · string

ISO timestamp.

has_more · boolean

Whether more pages exist.

pagination · object

Cursor envelope.

request_id · string

Request identifier.

cURL

curl "https://api.signa.so/v1/alerts?severity=critical&limit=50" \
  -H "Authorization: Bearer $SIGNA_API_KEY"