> ## 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.

# Retrieve Watch

> Get a single watch by ID, including its 24-hour alert volume

## Overview

Requires the `portfolios:manage` scope.

## Path Parameters

<ParamField path="id" type="string" required>
  Watch ID (`wat_*`).
</ParamField>

## Response

Returns the full `Watch` (see [Create Watch](/api-reference/monitoring/watches/create) for the
shape), with `alert_count_24h` populated from the last 24 hours of alerts produced by this
watch.

## Errors

| Status | `type`      | When                                          |
| ------ | ----------- | --------------------------------------------- |
| 404    | `not_found` | Watch doesn't exist or belongs to another org |

## Code Examples

<CodeGroup>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/watches/wat_8kLm2nPq" \
    -H "Authorization: Bearer sig_YOUR_KEY"
  ```

  ```typescript TypeScript theme={null}
  import { Signa } from "@signa-so/sdk";
  const signa = new Signa({ api_key: process.env.SIGNA_API_KEY });

  const watch = await signa.watches.retrieve("wat_8kLm2nPq");
  ```
</CodeGroup>

<ResponseExample>
  ```json theme={null}
  {
    "id": "wat_8kLm2nPq",
    "object": "watch",
    "name": "Class 9 filings (US/EU)",
    "watch_type": "class",
    "query": {
      "version": "v2",
      "filters": { "niceClasses": [9], "jurisdictions": ["US", "EU"] },
      "trigger_events": ["trademark.created", "trademark.status_changed"]
    },
    "delivery_mode": "always_per_alert",
    "status": "active",
    "alert_count_24h": 2,
    "last_alerted_at": "2026-07-05T09:12:00.000Z",
    "metadata": {},
    "created_at": "2026-05-11T10:00:00.000Z",
    "updated_at": "2026-05-11T10:00:00.000Z",
    "request_id": "req_7pQmX3Lv"
  }
  ```
</ResponseExample>

## Related Endpoints

* [List Watches](/api-reference/monitoring/watches/list) - `alert_count_24h` is always `null` there
* [List Alerts for Watch](/api-reference/monitoring/alerts/list-for-watch) - the alerts behind that count
* [Watch Diagnostics](/api-reference/monitoring/watches/diagnostics) - explain a specific match outcome