---
title: "Get monitor by ID"
method: GET
path: "/monitors/{monitorId}"
tags: ["monitors"]
---

# Get monitor by ID

`GET /monitors/{monitorId}`

Retrieve a specific monitor by its ID

## Path parameters

- `monitorId` string, required

## Response `200`

Monitor retrieved successfully

- object
  - `success` boolean, required
  - `msg` string, required
  - `data` object — Response payload (varies by endpoint)
    - `_id` string
    - `userId` string
    - `teamId` string
    - `name` string
    - `description` string
    - `type` 'http' | 'ping' | 'pagespeed' | 'hardware' | 'docker' | 'port'
    - `url` string, uri
    - `interval` integer
    - `isActive` boolean
    - `status` boolean — Current monitor status (up/down)
    - `lastChecked` string, date-time — Timestamp of last check
    - `notifications` string[]
    - `httpOptions` object
      - `method` string
      - `headers` object
      - `body` string
      - `timeout` integer
    - `assertions` object[]
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `404` — Resource not found
- `500` — Internal server error

## Changes

- **2025-08-11** `db719f9e3d34` — 1 breaking, 3 warning, 7 info
  - the response's body type changed from `object` to no type for status `200`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `msg` from the response with the `200` status
  - removed the optional property `success` from the response with the `200` status
  - …7 more
- **2025-04-20** `b97ec6888b3c` — 32 breaking, 13 warning, 8 info
  - the response property `data` became optional for the status `200`
  - 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`
  - …49 more

[Change history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/monitors/: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/8e4e53495dc9/schema)