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

# List all monitors

`GET /v1/monitors`

Returns a list of all monitors for a project.

## Response `200`

List of monitors

- Monitor[]
  - `uuid` string
  - `name` string
  - `url` string
  - `protocol` 'http' | 'port' | 'icmp'
  - `http_method` 'GET' | 'POST' | 'PUT' | 'HEAD' | 'DELETE' | 'PATCH' | 'OPTIONS'
  - `check_frequency` integer — Check interval in seconds
  - `regions` string[]
  - `status` 'up' | 'down'
  - `paused` boolean
  - `expected_status_code` string — Use "2xx" for 200-299, "1xx-3xx" for 100-399, or a specific code like "200"
  - `required_keyword` string
  - `follow_redirects` boolean
  - `port` integer, nullable
  - `ssl_expiration` integer — Days until SSL expiration
  - `alerts_wait` integer — Minutes before alerting (-1 to disable)
  - `escalation_policy` object, nullable
    - `uuid` string
    - `name` string

## Other responses

- `401` — Invalid or missing API key

---

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