Retrieve a Monitor Run

Fetch a single run by id, including its lifecycle status, timing, credits charged, and any change detected.

GET /monitors/{monitor_id}/runs/{run_id}

Retrieve a monitor run

cURL

curl --request GET \
  --url https://api.context.dev/v1/monitors/{monitor_id}/runs/{run_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "run_123",
  "monitor_id": "mon_123",
  "status": "queued",
  "run_type": "baseline",
  "target_type": "page",
  "change_detection_type": "exact",
  "change_detected": true,
  "baseline_created": true,
  "credits_charged": 1,
  "started_at": "2023-11-07T05:31:56Z",
  "completed_at": "2023-11-07T05:31:56Z",
  "change_id": "chg_123",
  "skip_reason": "insufficient_credits",
  "error": {
    "code": "fetch_failed",
    "message": "The target URL could not be fetched."
  },
  "webhook_delivery": {
    "event_id": "evt_123",
    "event": "change.detected",
    "status": "delivered",
    "http_status": 200,
    "attempted_at": "2023-11-07T05:31:56Z",
    "error": {
      "code": "fetch_failed",
      "message": "The target URL could not be fetched."
    }
  },
  "webhook_deliveries": [
    {
      "event_id": "evt_123",
      "event": "change.detected",
      "status": "delivered",
      "http_status": 200,
      "attempted_at": "2023-11-07T05:31:56Z",
      "error": {
        "code": "fetch_failed",
        "message": "The target URL could not be fetched."
      }
    }
  ]
}

0 Credits

Use this endpoint to check the outcome of a specific run — for example, the run_id returned by Run a Monitor Now — without paging through the monitor’s full history.

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <API_KEY>, where <API_KEY> is your api key.

Path Parameters

monitor_id · string · required

Example:

"mon_123"

run_id · string · required

Example:

"run_123"

Response

200

application/json

The requested monitor run

id · string · required

Example:

"run_123"

monitor_id · string · required

Example:

"mon_123"

status · enum<string> · required

Lifecycle status of a run. skipped runs never executed — see skip_reason (insufficient credits, monitor paused, or superseded by a concurrent run).

Available options: queued, running, completed, failed, skipped

run_type · enum<string> · required

The first run after monitor creation is a baseline run.

Available options: baseline, scheduled

target_type · enum<string> · required

Available options: page, sitemap, extract

change_detection_type · enum<string> · required

Available options: exact, semantic

change_detected · boolean · required

Example:

true

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

Required range: x >= 0

Example:

1

started_at · string<date-time> | null

completed_at · string<date-time> | null

change_id · string | null

Example:

"chg_123"

skip_reason · enum<string> | null

Why a skipped run never executed; null unless status is skipped.

Available options: insufficient_credits, monitor_paused, superseded, null

error · object | null

Show child attributes

webhook_delivery · object · deprecated

Deprecated: use webhook_deliveries, which records every attempt now that a run can deliver multiple events. Omitted when no webhook was attempted, including historical runs created before delivery tracking was added.

Show child attributes

webhook_deliveries · object[]

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.

Show child attributes