---
title: "Get monitors by team"
method: GET
path: "/monitors/team"
tags: ["monitors"]
---

# Get monitors by team

`GET /monitors/team`

Get monitors filtered by team with optional parameters

## Query parameters

- `status` boolean
- `type` 'http' | 'ping' | 'pagespeed' | 'hardware' | 'docker' | 'port'
- `page` integer
- `rowsPerPage` integer
- `filter` string
- `field` 'name' | 'url' | 'description'

## Response `200`

Team monitors retrieved successfully

- object
  - `success` boolean, required
  - `msg` string, required
  - `data` object — Response payload (varies by endpoint)
    - `monitors` Monitor[]
      - `_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
    - `totalCount` integer

## Other responses

- `500` — Internal server error

## Changes

- **2025-08-11** `db719f9e3d34` — 1 info
  - endpoint added
- **2025-04-20** `b97ec6888b3c` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/bluewave-labs/apis/checkmate-api/changes/monitors/team/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.dev/bluewave-labs/apis/checkmate-api/revisions/db719f9e3d34?raw)