---
title: "List monitor runs"
method: GET
path: "/monitors/{monitor_id}/runs"
tags: ["Monitors"]
---

# List monitor runs

`GET /monitors/{monitor_id}/runs`

## Path parameters

- `monitor_id` string, required

## Query parameters

- `status` 'queued' | 'running' | 'completed' | 'failed' | 'skipped' — Filter runs by lifecycle status.
- `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 runs for the monitor

- MonitorsListRunsResponse
  - `data` MonitorsRun[], required
    - `id` string, required
    - `monitor_id` string, required
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'skipped', required — Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (insufficient credits, monitor paused, or superseded by a concurrent run).
    - `run_type` 'baseline' | 'scheduled', required — The first run after monitor creation is a baseline run.
    - `target_type` 'page' | 'sitemap' | 'extract', required
    - `change_detection_type` 'exact' | 'semantic', required
    - `started_at` string, date-time, nullable
    - `completed_at` string, date-time, nullable
    - `change_detected` boolean, required
    - `change_id` string, nullable
    - `baseline_created` boolean, required — True when this run established the monitor's initial baseline; baseline runs perform no change detection.
    - `credits_charged` integer, required — Credits charged for this run (0 for skipped/failed runs).
    - `skip_reason` 'insufficient_credits' | 'monitor_paused' | 'superseded' | 'null', nullable — Why a skipped run never executed; null unless status is `skipped`.
    - `error` MonitorsNullableRunError
      - `code` string, required
      - `message` string, required
    - `webhook_delivery` MonitorsWebhookDelivery
      - `event_id` string, required — Identifier sent in the X-Context-Id header.
      - `event` 'change.detected' | 'run.completed', required — The event this delivery carried. Deliveries recorded before event selection existed report change.detected.
      - `status` 'delivered' | 'rejected' | 'failed' | 'skipped_unsafe_url', required — Delivery outcome. delivered means any 2xx response; rejected means a non-2xx response; failed means no HTTP response was received; skipped_unsafe_url means the URL failed the public-endpoint safety check.
      - `http_status` integer, nullable, required — The endpoint's final HTTP response status, or null when no response was received.
      - `attempted_at` string, date-time, required
      - `error` MonitorsNullableRunError, required
        - `code` string, required
        - `message` string, required
    - `webhook_deliveries` MonitorsWebhookDelivery[] — All webhook deliveries attempted by this run — one per subscribed event that fired. Omitted when no webhook was attempted, including runs created before event selection was added.
      - `event_id` string, required — Identifier sent in the X-Context-Id header.
      - `event` 'change.detected' | 'run.completed', required — The event this delivery carried. Deliveries recorded before event selection existed report change.detected.
      - `status` 'delivered' | 'rejected' | 'failed' | 'skipped_unsafe_url', required — Delivery outcome. delivered means any 2xx response; rejected means a non-2xx response; failed means no HTTP response was received; skipped_unsafe_url means the URL failed the public-endpoint safety check.
      - `http_status` integer, nullable, required — The endpoint's final HTTP response status, or null when no response was received.
      - `attempted_at` string, date-time, required
      - `error` MonitorsNullableRunError, required
        - `code` string, required
        - `message` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `401` — Unauthorized
- `404` — Not found

---

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