Skip to main content
GET
/
v1
/
watches
/
{id}
Get Watch
curl --request GET \
  --url https://api.example.com/v1/watches/{id}
{
  "id": "wat_Nk3pR8sT",
  "object": "watch",
    "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,
    "last_alert_at": "2026-03-22T08:15:00Z",
    "created_at": "2026-01-15T10:00:00Z",
  "updated_at": "2026-03-01T12:00:00Z",
  "livemode": true,
  "request_id": "req_mF2wX8yZ"
}

​
Overview

Returns the full configuration and status of a specific watch, including recent alert statistics. Use this to inspect a watch’s settings or verify it is active and correctly configured.

​
Path Parameters

​
id
string
required
Watch ID (e.g., wat_Nk3pR8sT)

​
Response

​
response
object
{
  "id": "wat_Nk3pR8sT",
  "object": "watch",
    "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,
    "last_alert_at": "2026-03-22T08:15:00Z",
    "created_at": "2026-01-15T10:00:00Z",
  "updated_at": "2026-03-01T12:00:00Z",
  "livemode": true,
  "request_id": "req_mF2wX8yZ"
}

​
Code Examples

curl https://api.signa.so/v1/watches/wat_Nk3pR8sT \
  -H "Authorization: Bearer sig_live_xxxxxxxxxxxx"

​
Errors

StatusTypeDescription
401unauthorizedMissing or invalid API key
404not_foundWatch ID does not exist
429rate_limitedToo many requests