---
title: "List monitors"
method: GET
path: "/monitors"
---

# List monitors

`GET /monitors`

## Request

- Base URL: `https://app.yoping.me/api/v1`
- URL: `https://app.yoping.me/api/v1/monitors`
- Auth: API key in cookie `yp_session`

Lists the account's monitors as operational summaries (status plus 24h/7d/30d uptime), cursor-paginated in id order.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

One page of monitor summaries.

- object: Cursor-paginated list envelope. `next_cursor` is an opaque token for the next page, or null on the last page.
  - `data` MonitorSummary[], required
    - `id` string, required
    - `type` 'http' | 'keyword' | 'ssl' | 'ping' | 'tcp', required
    - `name` string, required
    - `target` string, required
    - `interval_seconds` integer, required
    - `paused` boolean, required
    - `paused_reason` 'domain_conflict' | 'plugin_silent' | 'null', nullable, required: Why the system, not the user, paused this monitor; null while it is running or when the user paused it. domain_conflict: disabled because another account monitors this website's domain (free plan). plugin_silent: paused because the YoPingMe WordPress plugin on this site stopped reporting for 30 days; the plugin's next report resumes it automatically.
    - `current_status` 'up' | 'down' | 'confirming' | 'unknown', required
    - `alert_channel_ids` string[], required
    - `uptime_24h` number, nullable, required
    - `uptime_7d` number, nullable, required
    - `uptime_30d` number, nullable, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid input (code `validation_failed`): malformed JSON, a missing or out-of-range field, bad pagination parameters, or a rejected token.
- `401`: Not authenticated (code `unauthorized`): missing, invalid, or expired session; invalid login credentials; or a Bearer token, which this surface rejects.
- `429`: Too many requests (code `rate_limited`). A global per-IP budget of 300 requests/minute (burst 60) applies to every endpoint; login, signup, and test alerts have tighter dedicated limits.

---

[API](https://skmtc.dev/yoping/apis/yopingme-api.md) · [All operations](https://skmtc.dev/yoping/apis/yopingme-api/llms.txt) · [OpenAPI document](https://skmtc.dev/yoping/apis/yopingme-api/revisions/76d8deb40173?raw)