---
title: "List watchlist posts"
method: GET
path: "/api/v1/watchlist"
tags: ["v1"]
---

# List watchlist posts

`GET /api/v1/watchlist`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/v1/watchlist`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Watchlist posts

- V1WatchlistResponse
  - `data` V1Post[], required
    - `id` string, required
    - `sourceId` string, nullable, required
    - `url` string, nullable, required
    - `author` string, nullable, required
    - `preview` string, nullable, required
    - `relevanceScore` number, nullable, required
    - `lifecycleStatus` string, nullable, required
    - `createdAt` string, nullable, required
  - `total` number, required
  - `limit` number, required
  - `offset` number, required
  - `_meta` V1Meta, required
    - `mode` 'live' | 'sample', required
    - `notice` string
    - `cta` object
      - `text` string, required
      - `url` string, required

## Other responses

- `401`: Unauthorized
- `403`: Insufficient scope

---

[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)