---
title: "List this account's monitors"
method: GET
path: "/monitors"
tags: ["Monitors"]
---

# List this account's monitors

`GET /monitors`

## Request

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

Newest first. Never includes a signing secret.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Monitors.

- object
  - `monitors` Monitor[]
    - `id` string, uuid
    - `name` string
    - `targetUrl` string, uri
    - `captureParams` object: The capture options every run uses. Restricted to an allow-list; injectJS is not among them, so a scheduled unattended render can never carry caller-supplied JavaScript.
    - `intervalMinutes` integer
    - `status` 'active' | 'paused'
    - `checks` object
      - `markdown` boolean
      - `links` boolean
      - `title` boolean
      - `statusCode` boolean
      - `dom` boolean
    - `domIgnoreSelectors` string[]
    - `domIgnoreAttributes` string[]
    - `domIgnoreTextPatterns` string[]: Checked for catastrophic backtracking at save time, because the worker applies them under a CPU budget on every run.
    - `domPositionTolerancePx` integer
    - `notifyWebhookUrl` string, uri, nullable
    - `lastRunAt` string, date-time, nullable
    - `lastRunStatus` string, nullable
    - `nextRunAt` string, date-time, nullable
    - `consecutiveErrors` integer
    - `createdAt` string, date-time
    - `updatedAt` string, date-time, nullable
  - `limit` integer
  - `offset` integer
  - `plan` object
    - `maxMonitors` integer
    - `minIntervalMinutes` integer

## Other responses

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