Skip to main content
GET
/
v1
/
watches
/
{id}
/
alerts
Watch Alerts
curl --request GET \
  --url https://api.example.com/v1/watches/{id}/alerts

​
Overview

Returns the alerts generated by a single watch, with the same filters as the global List Alerts endpoint. Requires the portfolios:manage scope.

​
Path Parameters

​
id
string
required
Watch ID (wat_...).

​
Query Parameters

​
status
string
Filter by derived status. One of unacknowledged, acknowledged, dismissed.
​
severity
string
Filter by severity. One of high, medium, low, info.
​
trademark_id
string
Restrict to alerts about a specific trademark (tm_...).
​
event_type
string
Filter by event type(s), comma-separated.
​
sort
string
default:"-created_at"
Sort order. One of -created_at or created_at.
​
limit
integer
default:"20"
Page size (1-100).
​
cursor
string
Pagination cursor from a previous response.

​
Response

Returns a list envelope of alert records. See Get Alert for the field list.

​
Code Examples

curl "https://api.signa.so/v1/watches/wat_abc123/alerts?status=unacknowledged&severity=high&limit=20" \
  -H "Authorization: Bearer sig_live_YOUR_KEY_HERE"

​
Errors

StatusTypeDescription
400validation_errorInvalid watch ID, status, or severity
401unauthorizedMissing or invalid API key
403forbiddenAPI key lacks portfolios:manage
404not_foundWatch does not exist or belongs to another org