---
title: "List changes"
method: GET
path: "/monitors/changes"
tags: ["Monitors"]
---

# List changes

`GET /monitors/changes`

Returns an account-wide feed of detected changes across monitors.

## Query parameters

- `monitor_id` string — Filter changes to a single monitor.
- `target_type` 'page' | 'sitemap' | 'extract' — Filter by target type.
- `change_detection_type` 'exact' | 'semantic' — Filter by change detection type.
- `tag` string — Filter to items that have this tag.
- `since` string, date-time — Only include items at or after this ISO 8601 timestamp.
- `until` string, date-time — Only include items before this ISO 8601 timestamp.
- `limit` integer — Maximum number of items to return per page (1-100). Defaults to 25.
- `cursor` string — Opaque pagination cursor from a previous response.

## Response `200`

A paginated list of changes

- MonitorsListChangesResponse
  - `data` MonitorsChangeSummary[], required
    - `mode` 'web', required — Top-level monitor category. Always `web` today; the concrete behavior is described by `target` and `change_detection`.
    - `id` string, required
    - `monitor_id` string, required
    - `target_type` 'page' | 'sitemap' | 'extract', required
    - `change_detection_type` 'exact' | 'semantic', required
    - `title` string, required
    - `summary` string, required
    - `detected_at` string, date-time, required
    - `url` string, uri, required
    - `importance` 'low' | 'medium' | 'high'
    - `confidence` number
    - `added_url_count` integer
    - `removed_url_count` integer
    - `matched_url_count` integer
    - `tags` string[] — User-defined tags for grouping and filtering monitors and their changes. Duplicates are removed.
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/versions/182f532c2552/schema)