> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happyuptime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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).

Filter by status: `up`, `down`, `degraded`.

Filter by type: `http`, `ping`, `tcp`, `dns`, `keyword`, `heartbeat`.

Filter by tag.

## Request

```bash cURL
curl https://happyuptime.com/api/v1/monitors \
  -H "Authorization: Bearer hu_your_api_key"
```

```bash CLI
happy monitors list
```

```javascript Node
const 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
  }
}
```