---
title: "List checks for a monitor"
method: GET
path: "/checks/{monitorId}"
tags: ["checks"]
---

# List checks for a monitor

`GET /checks/{monitorId}`

## Path parameters

- `monitorId` string, required

## Query parameters

- `type` 'http' | 'ping' | 'pagespeed' | 'hardware' | 'docker' | 'port' | 'game' | 'grpc' | 'websocket' | 'dns' | 'unknown'
- `sortOrder` 'asc' | 'desc', required
- `limit` number, nullable
- `dateRange` 'recent' | 'hour' | 'day' | 'week' | 'month' | 'all', required
- `filter` 'all' | 'up' | 'down' | 'resolve'
- `ack` boolean
- `page` number, nullable
- `rowsPerPage` number, nullable
- `status` boolean
- `continent` union
  - 'EU' | 'NA' | 'AS' | 'SA' | 'AF' | 'OC'
  - string[]

## Response `200`

OK

- object
  - `success` true, required
  - `msg` string, required
  - `data` unknown

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

## Changes

- **2026-05-11** `59d86e7d3831` — 2 info
  - added the new enum value `dns` to the `query` request parameter `type`
  - added the new enum value `unknown` to the `query` request parameter `type`
- **2026-05-01** `39082d385dda` — 3 breaking, 2 warning, 13 info
  - added the new required `query` request parameter `dateRange`
  - added the new required `query` request parameter `sortOrder`
  - for the `path` request parameter `monitorId`, the minLength was increased from `0` to `1`
  - removed the optional property `details` from the response with the `500` status
  - …14 more
- **2025-08-11** `db719f9e3d34` — 1 breaking, 6 info
  - removed the media type `application/json` for the response with the status `200`
  - added the non-success response with the status `404`
  - removed the non-success response with the status `422`
  - added the optional property `details` to the response with the `500` status
  - …3 more
- **2025-04-20** `b97ec6888b3c` — 5 breaking, 11 warning, 8 info
  - the response property `msg` became optional for the status `200`
  - the response property `msg` became optional for the status `500`
  - the response property `success` became optional for the status `200`
  - the response property `success` became optional for the status `500`
  - …20 more

[Change history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/checks/:monitorId/get.md)

---

[API](https://skmtc.dev/bluewave-labs/apis/checkmate-api.md) · [All operations](https://skmtc.dev/bluewave-labs/apis/checkmate-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/checkmate-api/revisions/a9ac59e12c59/schema)