List monitors
Paginate and filter all monitors in your project.
List monitors
GET /monitors
List all monitors with pagination and filtering.
Auth: Bearer token (read scope)
Query parameters
Page number.
Items per page (max 100).
status string
Filter by status: up, down, degraded.
type string
Filter by type: http, ping, tcp, dns, keyword, heartbeat.
tag string
Filter by tag.
Request
curl https://happyuptime.com/api/v1/monitors \
-H "Authorization: Bearer hu_your_api_key"happy monitors listconst res = await fetch("https://happyuptime.com/api/v1/monitors", {
headers: { "Authorization": "Bearer " + process.env.HAPPYUPTIME_API_KEY },
});
const { data, meta } = await res.json();Response
json{ "data": [ { "id": "mon_abc123", "project_id": "proj_xyz", "name": "API Server", "type": "http", "url": "https://api.example.com/health", "method": "GET", "status": "up", "interval_seconds": 60, "timeout_ms": 30000, "regions": ["us-east", "eu-west", "ap-southeast"], "paused": false, "created_at": "2026-03-01T10:00:00Z", "updated_at": "2026-03-07T14:30:00Z" } ], "meta": { "page": 1, "per_page": 25, "total": 12, "total_pages": 1 } }