---
title: "List your opportunity watches."
method: GET
path: "/strategy/watches"
tags: ["Strategy"]
---

# List your opportunity watches.

`GET /strategy/watches`

## Request

- Base URL: `https://docs.sleeperhit.studio/api/v1`
- URL: `https://docs.sleeperhit.studio/api/v1/strategy/watches`
- Auth: HTTP bearer

The Strategy page's Watches: each watch's words, schedule, script, whether it runs, its last and next run, why the last run failed (in plain words) and how many opportunities it found. Most recently changed first. Free: a watch runs on its own schedule, or once now when asked, at no charge, and reading, promoting or editing changes only your own Strategy. Scope: `story:read`.

## Response `200`

Your watches.

- OpportunityWatchList
  - `watches` OpportunityWatch[], required
    - `id` string, required
    - `name` string, required
    - `query` string, required
    - `category` string, required
    - `cadence` string, required
    - `active` boolean, required: False while paused: listed, but it does not run.
    - `script` object, nullable, required
      - `id` string, required
      - `title` string, required
    - `lastRunAt` string, date-time, nullable, required
    - `nextRunAt` string, date-time, nullable, required
    - `lastError` string, nullable, required: Why the last run failed, in plain words; null when it worked or has not run.
    - `runCount` integer, required
    - `opportunityCount` integer, required: How many opportunities it has found.
    - `updatedAt` string, date-time, required

## Other responses

- `401`: Missing, malformed, revoked, or expired API key.
- `403`: API key is valid but lacks the scope, is blocked by IP allowlist, or the account is disabled.
- `429`: Rate limit for this API key + IP + route family was exceeded.
- `500`: The API failed unexpectedly. Safe to retry with the same Idempotency-Key.
- `503`: `strategy_unavailable`: Strategy, or its watches, is switched off right now.

---

[API](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api.md) · [All operations](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sleeperhit/apis/sleeper-hit-studio-story-api/revisions/4534f5d25540?raw)