---
title: "Monitor Stats"
method: GET
path: "/v1/monitors/stats"
tags: ["Monitor"]
---

# Monitor Stats

`GET /v1/monitors/stats`

## Request

- Base URL: `https://api.parallel.ai`
- URL: `https://api.parallel.ai/v1/monitors/stats`
- Auth: API key in header `x-api-key`

Return aggregate counts of your monitors.

Counts every monitor across all statuses, broken down by status and then
by processor and run frequency (e.g. '1h', '1d') within each status.
Statuses, processors, and frequencies with zero monitors are omitted.
Use this instead of paginating List Monitors when only counts are needed.

## Response `200`

Aggregate monitor counts.

- MonitorStatsResponse: Aggregate counts of the authenticated client's monitors.
  - `total` integer, required: Total number of monitors across all statuses and processors.
  - `processor_counts` object, required: Number of monitors per run frequency (e.g. '1h', '1d'), keyed by status and processor. Statuses, processors, and frequencies with zero monitors are omitted.

## Other responses

- `401`: Unauthorized: invalid or missing credentials

## Changes

- **2026-10-16** `fc4858951ccf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/parallel-web/apis/parallel-api/changes/v1/monitors/stats/get.md)

---

[API](https://skmtc.dev/parallel-web/apis/parallel-api.md) - [All operations](https://skmtc.dev/parallel-web/apis/parallel-api/llms.txt) - [OpenAPI document](https://skmtc.dev/parallel-web/apis/parallel-api/revisions/eae6def9641f?raw)