---
title: "Active watched posts (closed posts NEVER returned per spec §9.5)"
method: GET
path: "/api/me/watchlist"
tags: ["me"]
---

# Active watched posts (closed posts NEVER returned per spec §9.5)

`GET /api/me/watchlist`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/watchlist`
- Auth: none declared

is_active=true is hard-coded. Optional `status` query narrows on lifecycle_status (qualified | harvesting | max_harvests).

## Query parameters

- `status` string
- `source` string, uuid: Source ID filter (single source UUID)
- `sourceType` string: Filter to all sources of this type (e.g. "keyword_search"). Mutually exclusive with `source` in practice.
- `days` string
- `limit` string
- `offset` string
- `sortBy` 'likes' | 'comments' | 'postedAt' | 'createdAt' | 'expiresAt': Server-side sort column. Default createdAt.
- `sortDir` 'asc' | 'desc': Sort direction. Default desc.

## Response `200`

Watchlist

- MeWatchedPostListResponse
  - `posts` WatchedPost[], required
    - `id` string, uuid, required
    - `customerId` string, uuid, required
    - `sourceId` string, uuid, required
    - `postUrl` string, required
    - `postUrn` string, required
    - `postAuthorName` string, nullable, required
    - `postTextPreview` string, nullable, required
    - `postedAt` string, date-time, nullable, required
    - `tier` string, required: Harvest tier (A/B/C)
    - `initialLikes` integer, required
    - `initialComments` integer, required
    - `latestLikes` integer, required
    - `latestComments` integer, required
    - `isActive` boolean, required
    - `createdAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `harvestCount` integer, required
    - `lifecycleStatus` string, required: discovered | qualified | harvesting | closed
    - `closedReason` string, nullable, required
    - `relevanceScore` integer, nullable, required: 1=strong, 5=irrelevant
    - `relevanceReason` string, nullable, required
    - `aiPostSummary` string, nullable, required
  - `total` integer, required
  - `limit` integer, required
  - `offset` integer, required

---

[API](https://skmtc.dev/signalraven/apis/zygnal-api.md) · [All operations](https://skmtc.dev/signalraven/apis/zygnal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/signalraven/apis/zygnal-api/revisions/36e1d9b9d604?raw)