Skip to main content
GET
/
v1
/
watches
List Watches
curl --request GET \
  --url https://api.example.com/v1/watches
{
  "object": "list",
  "data": [
    {
      "id": "wat_Nk3pR8sT",
      "name": "AURORA brand watch",
      "watch_type": "keyword",
      "criteria": {
        "query": "AURORA",
        "match": "phonetic"
      },
      "triggers": ["new_filing", "status_change"],
      "scope_filters": {
        "office_code": ["uspto", "euipo", "ukipo"],
        "nice_classes": [9, 35, 42]
      },
      "delivery_channels": ["api"],
      "status": "active",
      "alert_count": 7,
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "wat_Pm5qS9tU",
      "name": "NEXTERA competitor watch",
      "watch_type": "competitor",
      "criteria": {
        "owner_name": "Nextera Corp"
      },
      "triggers": ["new_filing", "any_change"],
      "scope_filters": null,
      "delivery_channels": ["api"],
      "status": "active",
      "alert_count": 12,
      "created_at": "2026-02-20T14:30:00Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_lE1vW7xY"
}

Overview

Returns a paginated list of all watches configured for your organization. Each watch includes its configuration, current status, and alert count. Use this to audit your active monitoring coverage or build a watch management dashboard.

Query Parameters

limit
integer
default:"20"
Items per page (max 100)
cursor
string
Pagination cursor from previous response
status
string
Filter by watch status: active or paused

Response

data
object[]
Array of watch objects.
{
  "object": "list",
  "data": [
    {
      "id": "wat_Nk3pR8sT",
      "name": "AURORA brand watch",
      "watch_type": "keyword",
      "criteria": {
        "query": "AURORA",
        "match": "phonetic"
      },
      "triggers": ["new_filing", "status_change"],
      "scope_filters": {
        "office_code": ["uspto", "euipo", "ukipo"],
        "nice_classes": [9, 35, 42]
      },
      "delivery_channels": ["api"],
      "status": "active",
      "alert_count": 7,
      "created_at": "2026-01-15T10:00:00Z"
    },
    {
      "id": "wat_Pm5qS9tU",
      "name": "NEXTERA competitor watch",
      "watch_type": "competitor",
      "criteria": {
        "owner_name": "Nextera Corp"
      },
      "triggers": ["new_filing", "any_change"],
      "scope_filters": null,
      "delivery_channels": ["api"],
      "status": "active",
      "alert_count": 12,
      "created_at": "2026-02-20T14:30:00Z"
    }
  ],
  "has_more": false,
  "pagination": {
    "cursor": null
  },
  "livemode": true,
  "request_id": "req_lE1vW7xY"
}

Code Examples

curl "https://api.signa.so/v1/watches?status=active" \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

Errors

StatusTypeDescription
400validation_errorInvalid query parameters
401unauthorizedMissing or invalid API key
429rate_limitedToo many requests