Skip to main content

​
Overview

The List Checks endpoint returns all monitoring checks (browser checks, API checks, and heartbeat checks) configured in your Checkly account. Use this endpoint to get an overview of your monitoring setup or to programmatically manage your checks.
This endpoint returns both active and paused checks. Use the activated field in the response to determine the current status of each check.

​
Common Use Cases

Monitor All Active Checks

Get all currently running checks to verify your monitoring coverage
GET /v1/checks?activated=true

Filter by Environment

Use tags to filter checks by environment or criticality
GET /v1/checks?tags=production,critical

Check Type Analysis

Analyze your monitoring setup by check types
GET /v1/checks?checkType=BROWSER

Audit Inactive Checks

Find paused checks that might need attention
GET /v1/checks?activated=false

​
Response Example

{
  "checks": [
    {
      "id": "73208bf5-2b42-4ab3-b18c-7ac505b7d7b4",
      "name": "Homepage Load Test",
      "checkType": "BROWSER",
      "frequency": 5,
      "activated": true,
      "muted": false,
      "shouldFail": false,
      "locations": ["us-east-1", "eu-west-1", "ap-southeast-1"],
      "tags": ["production", "critical", "homepage"],
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-20T14:45:00.000Z",
      "script": "// Playwright browser check script\nconst { test, expect } = require('@playwright/test');\n\ntest('Homepage loads successfully', async ({ page }) => {\n  await page.goto('https://example.com');\n  await expect(page).toHaveTitle(/Example/);\n});",
      "environmentVariables": [
        {
          "key": "BASE_URL",
          "value": "https://example.com",
          "locked": false
        }
      ]
    },
    {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "API Health Check",
      "checkType": "API",
      "frequency": 2,
      "activated": true,
      "muted": false,
      "shouldFail": false,
      "locations": ["us-east-1", "eu-west-1"],
      "tags": ["production", "api", "health"],
      "createdAt": "2024-01-10T08:15:00.000Z",
      "updatedAt": "2024-01-18T16:20:00.000Z",
      "script": "// API check script\nconst response = await fetch('https://api.example.com/health');\nexpect(response.status).toBe(200);",
      "environmentVariables": []
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 100,
    "totalPages": 1,
    "totalItems": 2
  }
}

​
Additional Examples

curl -X GET "https://api.checklyhq.com/v1/checks?checkType=BROWSER&activated=true" \
  -H "Authorization: Bearer cu_1234567890abcdef" \
  -H "X-Checkly-Account: 550e8400-e29b-41d4-a716-446655440000"
The checks returned by this endpoint include all check types in your account. Use the checkType filter to focus on specific monitoring types, or the tags parameter to filter by your organizational structure.