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

# List Monitors

`GET /v1/monitors`

List monitors ordered by creation time, newest first.

Monitors are sorted by `created_at` descending. `limit` defaults to 100.
Use `next_cursor` from the response and pass it as `cursor` to fetch the
next page. Pagination ends when `next_cursor` is absent.

By default only `active` monitors are returned. Pass `status=cancelled`
or both values to include cancelled monitors.

The legacy Monitor API (`/v1alpha/monitors` endpoints) is documented under
the `Monitor (Alpha)` tag.

## Query parameters

- `cursor` string, nullable — Pagination token from `next_cursor` in a previous response. Omit to start from the most recently created monitor.
- `limit` integer, nullable — Maximum number of monitors to return. Defaults to 100. Between 1 and 10000.
- `type` string[], nullable — Filter by monitor type. Pass multiple times to filter by multiple values. Omit to return all types.
- `status` string[], nullable — Filter by monitor status. Pass multiple times to filter by multiple values. Defaults to `active` only.

## Response `200`

Paginated list of monitors.

- PaginatedMonitorResponse — Paginated list of monitors.
  - `monitors` MonitorResponse[], required — List of monitors for the current page.
    - `type` 'event_stream' | 'snapshot', required — The type of monitor.
    - `monitor_id` string, required — ID of the monitor.
    - `status` 'active' | 'cancelled', required — Status of the monitor.
    - `frequency` string, required — Frequency of the monitor. Format: '<number><unit>' where unit is 'h' (hours), 'd' (days), or 'w' (weeks). Must be between 1h and 30d (inclusive).
    - `processor` 'lite' | 'base', required — Processor to use for the monitor. `lite` is faster and cheaper; `base` performs more thorough analysis at higher cost and latency. Defaults to `lite`.
    - `webhook` MonitorWebhook — Webhook configuration for a monitor.
      - `url` string, required — URL for the webhook.
      - `event_types` string[] — Event types to send the webhook notifications for.
    - `metadata` object, nullable — User-provided metadata stored with the monitor and echoed back in webhook notifications and GET responses, so you can map events to objects in your application. Keys: max 16 chars; values: max 512 chars.
    - `created_at` string, date-time, required — Timestamp of the creation of the monitor, as an RFC 3339 string.
    - `last_run_at` string, nullable — Timestamp of the last run for the monitor, as an RFC 3339 string.
    - `settings` union, required — Type-specific configuration. Shape is determined by `type`: `MonitorEventStreamResponseSettings` for `event_stream`, `MonitorSnapshotResponseSettings` for `snapshot`.
      - MonitorEventStreamResponseSettings — Type-specific response fields for an `event_stream` monitor.
        - `query` string, required — The search query being monitored.
        - `output_schema` JsonSchema — JSON schema for a task input or output.
          - `json_schema` object, required — A JSON Schema object. Only a subset of JSON Schema is supported.
          - `type` 'json' — The type of schema being defined. Always `json`.
        - `include_backfill` boolean, nullable — If true, the first execution returns a sample of recent historical events matching the query (preview only — not exhaustive). If false or omitted, only events from the monitor's creation date onward are returned. Subsequent executions are always incremental.
        - `advanced_settings` AdvancedMonitorSettings — Advanced monitor configuration.
          - `source_policy` SourcePolicy — Source policy for web search results. This policy governs which sources are allowed/disallowed in results.
            - `include_domains` string[] — List of domains to restrict the results to. If specified, only sources from these domains will be included. Accepts plain domains (e.g., example.com, subdomain.example.gov) or bare domain extension starting with a period (e.g., .gov, .edu, .co.uk). The combined number of domains in include_domains and exclude_domains cannot exceed 200.
            - `exclude_domains` string[] — List of domains to exclude from results. If specified, sources from these domains will be excluded. Accepts plain domains (e.g., example.com, subdomain.example.gov) or bare domain extension starting with a period (e.g., .gov, .edu, .co.uk). The combined number of domains in include_domains and exclude_domains cannot exceed 200.
            - `after_date` string, date, nullable — Optional start date for filtering search results. Results will be limited to content published on or after this date. Provided as an RFC 3339 date string (YYYY-MM-DD).
          - `location` string, nullable — ISO 3166-1 alpha-2 country code for geo-targeted monitor results.
      - MonitorSnapshotResponseSettings — Configuration settings for a `snapshot` monitor.
        - `task_run_id` string, required — ID of the task run used as the monitoring baseline.
        - `query` string, required — The original task input from the baseline task run that this monitor tracks.
        - `output_schema` JsonSchema — JSON schema for a task input or output.
          - `json_schema` object, required — A JSON Schema object. Only a subset of JSON Schema is supported.
          - `type` 'json' — The type of schema being defined. Always `json`.
    - `output` MonitorSnapshotOutput — Runtime output state for a `snapshot` monitor.
      - `latest_snapshot` union — Task run output from the most recent completed execution of this snapshot monitor — same structure as the output of the original task run the monitor was created from. `null` until the first run completes.
        - TaskRunTextOutput — Output from a task that returns text.
          - `basis` FieldBasis[], required — Basis for the output. The basis has a single field 'output'.
            - `field` string, required — Name of the output field.
            - `citations` Citation[] — List of citations supporting the output field.
              - …
            - `reasoning` string, required — Reasoning for the output field.
            - `confidence` string, nullable — Confidence level for the output field. Only certain processors provide confidence levels.
          - `type` 'text', required — The type of output being returned, as determined by the output schema of the task spec.
          - `mcp_tool_calls` McpToolCall[], nullable — MCP tool calls made by the task.
            - `tool_call_id` string, required — Identifier for the tool call.
            - `server_name` string, required — Name of the MCP server.
            - `tool_name` string, required — Name of the tool being called.
            - `arguments` string, required — Arguments used to call the MCP tool.
            - `content` string, nullable — Output received from the tool call, if successful.
            - `error` string, nullable — Error message if the tool call failed.
          - `beta_fields` object, nullable — Deprecated. mcp-server-2025-07-17 is now included directly in the output (e.g. mcp_tool_calls).
          - `content` string, required — Text output from the task.
        - TaskRunJsonOutput — Output from a task that returns JSON.
          - `basis` FieldBasis[], required — Basis for each top-level field in the JSON output. Per-list-element basis entries are available only when the `parallel-beta: field-basis-2025-11-25` header is supplied.
            - `field` string, required — Name of the output field.
            - `citations` Citation[] — List of citations supporting the output field.
              - …
            - `reasoning` string, required — Reasoning for the output field.
            - `confidence` string, nullable — Confidence level for the output field. Only certain processors provide confidence levels.
          - `type` 'json', required — The type of output being returned, as determined by the output schema of the task spec.
          - `mcp_tool_calls` McpToolCall[], nullable — MCP tool calls made by the task.
            - `tool_call_id` string, required — Identifier for the tool call.
            - `server_name` string, required — Name of the MCP server.
            - `tool_name` string, required — Name of the tool being called.
            - `arguments` string, required — Arguments used to call the MCP tool.
            - `content` string, nullable — Output received from the tool call, if successful.
            - `error` string, nullable — Error message if the tool call failed.
          - `beta_fields` object, nullable — Deprecated. mcp-server-2025-07-17 is now included directly in the output (e.g. mcp_tool_calls).
          - `content` object, required — Output from the task as a native JSON object, as determined by the output schema of the task spec.
          - `output_schema` object, nullable — Output schema for the Task Run. Populated only if the task was executed with an auto schema.
  - `next_cursor` string, nullable — Opaque pagination token. Pass as `cursor` to retrieve the next page. Absent when there are no more pages.

## Other responses

- `401` — Unauthorized: invalid or missing credentials
- `422` — Validation Error

---

[API](https://skmtc.net/parallel-web/apis/parallel-api.md) · [All operations](https://skmtc.net/parallel-web/apis/parallel-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/parallel-web/parallel-api/versions/973957d74ceb/schema)