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

# List runs

`GET /monitors/runs`

Returns an account-wide feed of monitor runs across all monitors.

## Query parameters

- `status` 'queued' | 'running' | 'completed' | 'failed' | 'skipped' — Lifecycle status of a run. `skipped` runs never executed — see `skip_reason` (insufficient credits, monitor paused, or superseded by a concurrent run).
- `limit` integer
- `cursor` string

## Response `200`

A paginated list of runs

- 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', nullable — Why a skipped run never executed; null unless status is `skipped`.
    - `error` MonitorsNullableRunError
      - `code` string, required
      - `message` string, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `401` — Unauthorized

## Changes

- **2026-07-09** `de91b92d5fb7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/context/apis/context-dev/changes/monitors/runs/get.md)

---

[API](https://skmtc.dev/context/apis/context-dev.md) · [All operations](https://skmtc.dev/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context/context-dev/revisions/de91b92d5fb7/schema)