---
title: "List Monitor Matches"
method: GET
path: "/monitors/{id}/matches"
tags: ["Monitors"]
---

# List Monitor Matches

`GET /monitors/{id}/matches`

## Request

- Base URL: `https://api.croma.run`
- URL: `https://api.croma.run/monitors/{id}/matches`
- Auth: HTTP bearer

Every row the monitor has reported, newest first, with the relevance filter's verdict when the monitor has one.

## Path parameters

- `id` string, required

## Query parameters

- `relevant` boolean
- `page` integer
- `per_page` integer

## Response `200`

Matches and pagination.

- MonitorMatchListResponse
  - `data` object, required
    - `results` MonitorMatch[], required
      - `id` string, required
      - `record_key` string, required
      - `record` object, required: The row as the endpoint returned it. On a monitor that watches one record (a lookup), a match is either an item of one of the record's lists or a reading of the record itself without its lists.
      - `changes` object[], nullable, required: On a reading of a watched record after the first: each value that moved, by its path in the record. Null on a new row or item.
        - `path` string, required
        - `before` unknown, required
        - `after` unknown, required
      - `relevant` boolean, nullable, required: The relevance filter's verdict; null when the monitor has no filter or the filter was unavailable.
      - `relevance_reason` string, nullable, required
      - `first_seen_at` string, date-time, required
      - `run_id` string, required
    - `pagination` Pagination, required
      - `total` integer, required
      - `page_size` integer, required
      - `total_pages` integer, required
      - `page` integer, required

## Other responses

- `401`: Missing or invalid API key
- `403`: Monitors are in private beta and not enabled for the organization yet (`monitors_not_enabled`)
- `404`: Monitor not found
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/usecroma/apis/croma-marketplace-api.md) · [All operations](https://skmtc.dev/usecroma/apis/croma-marketplace-api/llms.txt) · [OpenAPI document](https://skmtc.dev/usecroma/apis/croma-marketplace-api/revisions/df016cdb29d7?raw)