---
title: "Read a monitor's run history"
method: GET
path: "/monitors/{monitorId}/runs"
tags: ["Monitors"]
---

# Read a monitor's run history

`GET /monitors/{monitorId}/runs`

## Request

- Base URL: `https://api.domscout.io`
- URL: `https://api.domscout.io/monitors/{monitorId}/runs`
- Auth: API key in header `x-api-key`

Newest first. changeDetected and changedFields are what a check concluded; captureId points at the saved artifact for that run.

## Path parameters

- `monitorId` string, uuid, required

## Query parameters

- `limit` integer

## Response `200`

Runs.

- object
  - `monitorId` string
  - `limit` integer
  - `runs` MonitorRun[]
    - `id` string, uuid
    - `monitorId` string, uuid
    - `status` string: The run's outcome. changed and unchanged are completed comparisons against the previous run. challenged means the capture was the target's anti-bot or access-verification page: nothing was compared, no notification was sent, error explains why, and the run is never used as a later run's baseline. error means the run failed.
    - `changeDetected` boolean, nullable
    - `changedFields` string[], nullable
    - `domChanged` boolean, nullable
    - `domChangeSummary` object, nullable
    - `captureId` string, uuid, nullable
    - `diffId` string, uuid, nullable
    - `error` string, nullable
    - `latencyMs` integer, nullable
    - `createdAt` string, date-time
    - `startedAt` string, date-time, nullable

## Other responses

- `404`: Not found.
- `503`: A dependency this request needs is unavailable or not configured for this deployment. Codes: SUPABASE_TIMEOUT and SUPABASE_INVALID_RESPONSE (a storage operation did not answer, or answered unreadably — the write may have committed, so any retry must be idempotent), CAPTURE_ARTIFACT_UNAVAILABLE and CAPTURE_ARTIFACT_CORRUPT (a stored artifact could not be read or parsed), ASYNC_JOBS_NOT_CONFIGURED and CAPTURE_RETRIEVAL_NOT_CONFIGURED (the capability is not configured here, on any plan). Retryable unless the code names a deployment configuration.

---

[API](https://skmtc.dev/domscout/apis/domscout-api.md) · [All operations](https://skmtc.dev/domscout/apis/domscout-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domscout/apis/domscout-api/revisions/20562d5b5d94?raw)