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

# List Watches

> List watches for the calling organization, with cursor pagination

## Overview

Returns the calling org's watches with opaque cursor pagination. Soft-deleted
watches are excluded.

Required scope: `portfolios:manage`.

## Query Parameters

<ParamField query="limit" type="integer" default="20">Page size (1--100).</ParamField>
<ParamField query="cursor" type="string">Opaque cursor returned in the previous response.</ParamField>
<ParamField query="status" type="string">Filter by status: `active`, `paused`, or `disabled`.</ParamField>

## Response

<ResponseField name="object" type="string">Always `"list"`.</ResponseField>

<ResponseField name="data" type="object[]">
  Array of `Watch` summaries (see [Create Watch](/api-reference/monitoring/watches/create) for the shape).

  <Info>**`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](/api-reference/monitoring/watches/retrieve) on its ID.</Info>
</ResponseField>

<ResponseField name="has_more" type="boolean">True when more pages exist.</ResponseField>
<ResponseField name="pagination" type="object"><Expandable title="pagination"><ResponseField name="cursor" type="string | null">Opaque cursor for the next page.</ResponseField></Expandable></ResponseField>
<ResponseField name="request_id" type="string">Request identifier.</ResponseField>

## Example

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.signa.so/v1/watches?status=active&limit=50" \
    -H "Authorization: Bearer $SIGNA_API_KEY"
  ```

  ```ts TypeScript theme={null}
  const watches = await signa.watches.list({ status: 'active', limit: 50 });
  for await (const w of watches) {
    console.log(w.id, w.name, w.watch_type);
  }
  ```
</RequestExample>