---
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

- `type` union
  - 'http' | 'ping' | 'pagespeed' | 'docker' | 'hardware' | 'port' | 'game' | 'grpc' | 'websocket'
  - string[]
- `filter` string

## 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

- **2026-03-18** `cd5518087304` — 6 breaking, 4 warning, 2 info
  - removed the enum value `docker` from the `query` request parameter `type`
  - removed the enum value `hardware` from the `query` request parameter `type`
  - removed the enum value `http` from the `query` request parameter `type`
  - removed the enum value `pagespeed` from the `query` request parameter `type`
  - …8 more
- **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-service-production.skmtc.workers.dev/v1/apis/bluewave-labs/checkmate-api/revisions/8e4e53495dc9/schema)