Accounts11

Alert channels6

Alert notifications1

Analytics12

Badges2

Check alerts2

Check groups11

Check results4

Check sessions7

Check status2

Checks15

Client certificates4

Dashboards5

Deployment Triggers2

Elements2

Environment variables5

Error Groups4

Heartbeats5

Incident Updates3

Incidents4

Location1

Maintenance windows12

Monitors14

Private locations8

Reporting1

Rocky AI3

Runtimes2

Secret scans1

Snippets5

Static IPs6

Status Page Incidents10

Status Page Services5

Status Pages8

Status Pages V37

Status Pages V3 Automation Rules5

Status Pages V3 Components5

Status Pages V3 Incidents11

Status Pages V3 Subscribers3

Test Session Error Groups4

Test sessions7

Triggers6

Usage8

Checks

List all checks

Changed on Oct 31, 2026

Lists all current checks in your account.

Unlike /v1, this endpoint does not return the flat project, logicalId, member and pending fields. A check can be managed by more than one project and each of those fields can name only one of them; projectBindings reports every binding, and is identical on /v1 and /v2.

Versioning is per endpoint. Only endpoints whose response or payload changed have a /v2; everything else remains on /v1 and is unaffected. In particular the check groups themselves, and creating, updating and deleting checks, are unchanged and stay on /v1.

get/v2/checks

Request

Base URL
https://api.checklyhq.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/checklyhq/apis/checkly-public-api/docs/v2/checks/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

limitinteger

Limit the number of results

pagenumber

Page number

apiCheckUrlFilterPatternstring

Filters the results by a string contained in the URL of an API check, for instance a domain like "www.myapp.com". Only returns API checks.

tagstring[]

Filters checks by tags. Returns checks that have at least one of the specified tags.

Filters checks by type. Returns checks that match the specified type.

searchstring

Filters checks by name using a case-insensitive partial match.

status'passing' | 'failing' | 'degraded'

Filters checks by current status.

applyGroupSettingsboolean

Checks that belong to a group are returned with group settings applied.

Headers

x-checkly-accountstring uuid

Your Checkly account ID, you can find it at https://app.checklyhq.com/settings/account/general

Response

Successful

Example response

[
  {
    "projectBindings": {
      "owner": {
        "binding": {
          "logicalId": "homepage-check",
          "sourceFile": "src/__checks__/homepage.check.ts"
        }
      },
      "references": [
        {
          "binding": {
            "logicalId": "homepage-check",
            "sourceFile": "src/__checks__/homepage.check.ts"
          }
        }
      ]
    }
  }
]

Changes

Oct 31, 2026bc90d1bfa738 Revision changes
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
Oct 7, 2026aba5d34c749b Revision changes
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property ///// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property ///////// to the response with the status

Operation history (3 revisions)