---
title: "Get a monitor check"
method: GET
path: "/monitor/{monitorId}/checks/{checkId}"
tags: ["Monitoring"]
---

# Get a monitor check

`GET /monitor/{monitorId}/checks/{checkId}`

## Path parameters

- `monitorId` string, uuid, required
- `checkId` string, uuid, required

## Query parameters

- `limit` integer
- `skip` integer
- `status` 'same' | 'new' | 'changed' | 'removed' | 'error'

## Response `200`

Monitor check details

- MonitorCheckDetailResponse
  - `success` boolean
  - `next` string, nullable — URL to fetch the next page of monitor check page results, if any.
  - `data` object
    - `id` string, uuid
    - `monitorId` string, uuid
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'partial' | 'skipped_overlap'
    - `trigger` 'scheduled' | 'manual'
    - `scheduledFor` string, date-time, nullable
    - `startedAt` string, date-time, nullable
    - `finishedAt` string, date-time, nullable
    - `estimatedCredits` integer, nullable — Upper-bound credits reserved for this check before Firecrawl knows how many pages changed and require judging.
    - `reservedCredits` integer, nullable
    - `actualCredits` integer, nullable — Final credits charged for this check after scrapes, crawls, and any changed-page judge calls complete.
    - `billingStatus` string
    - `summary` MonitorSummary
      - `totalPages` integer
      - `same` integer
      - `changed` integer
      - `new` integer
      - `removed` integer
      - `error` integer
    - `targetResults` unknown[], nullable
      - unknown
    - `notificationStatus` object, nullable
    - `error` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `pages` MonitorCheckPage[]
      - `id` string, uuid
      - `targetId` string
      - `url` string, uri
      - `status` 'same' | 'new' | 'changed' | 'removed' | 'error'
      - `previousScrapeId` string, uuid, nullable
      - `currentScrapeId` string, uuid, nullable
      - `statusCode` integer, nullable
      - `error` string, nullable
      - `metadata` object, nullable — Extra per-page metadata. For search monitors this includes `searchStatus`, the finer-grained search disposition behind the top-level `status`: `alert` (maps to `new`), `already_seen`, `watching`, `ignored` (all map to `same`), or `skipped` (maps to `error`).
      - `judgment` MonitorPageJudgment, nullable
        - `meaningful` boolean — Whether the changed page is meaningful for the monitor goal.
        - `confidence` 'high' | 'medium' | 'low'
        - `reason` string
        - `meaningfulChanges` object[] — Goal-relevant changes selected by the judge from the page diff.
          - `type` 'added' | 'removed' | 'changed'
          - `before` string, nullable
          - `after` string, nullable
          - `reason` string
      - `diff` object, nullable — Inline diff artifact when the page changed. The shape depends on what the monitor's scrapeOptions.formats asked for. Markdown-only monitors populate both `text` (unified diff) and `json` (parseDiff AST). JSON-extraction monitors populate `json` as a per-field `{previous, current}` map keyed by JSON path. Mixed-mode monitors (`changeTracking` with both `json` and `git-diff` modes) populate both `text` (markdown sidecar) and `json` (per-field diff).
        - `text` string — Unified markdown diff. Present on markdown-only and mixed-mode monitors.
        - `json` object — For markdown-only monitors, a parseDiff AST `{ files: [...] }`. For JSON-extraction (and mixed-mode) monitors, a per-field `{ previous, current }` map keyed by the JSON path into the extraction (e.g. `plans[0].price`).
      - `snapshot` object, nullable — Snapshot of the current JSON extraction at this run. Present on JSON-extraction and mixed-mode monitors; absent for markdown-only monitors.
        - `json` object — The full structured JSON extracted on this run, matching the schema/prompt declared on the target's `changeTracking` format.
      - `createdAt` string, date-time
    - `next` string, nullable — URL to fetch the next page of monitor check page results, if any.

## Other responses

- `404` — Monitor check not found

---

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