List Watches

List watches for the calling organization, with cursor pagination

GET /v1/watches

cURL

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

200

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

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

Show pagination

cursor · string | null

Opaque cursor for the next page.

request_id · string

Request identifier.

Example

cURL

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