Skip to main content
GET
/
v1
/
watches
curl "https://api.signa.so/v1/watches?status=active&limit=50" \
  -H "Authorization: Bearer $SIGNA_API_KEY"

{
  "object": "<string>",
  "data": [
    {}
  ],
  "has_more": true,
  "pagination": {},
  "request_id": "<string>"
}

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.

​
Overview

Returns the calling org’s watches with opaque cursor pagination. Soft-deleted watches are excluded. Required scope: portfolios:manage.

​
Query Parameters

​
limit
integer
default:"20"
Page size (1—100).
​
cursor
string
Opaque cursor returned in the previous response.
​
status
string
Filter by status: active, paused, or disabled.

​
Response

​
object
string
Always "list".
​
data
object[]
Array of Watch summaries (see Create Watch for the shape).
alert_count_24h is always null on list responses — computing it per row would issue one query per watch (intolerable for large fleets). To retrieve the 24h alert count for a specific watch, call Retrieve Watch on its ID.
​
has_more
boolean
True when more pages exist.
​
pagination
object
​
request_id
string
Request identifier.

​
Example

curl "https://api.signa.so/v1/watches?status=active&limit=50" \
  -H "Authorization: Bearer $SIGNA_API_KEY"