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 integer default: 1

Page number.

per_page integer default: 25

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"

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 } }
Ask a question... ⌘I