---
title: "List monitor events"
method: GET
path: "/v1/monitors/{monitorId}/events"
tags: ["monitors"]
---

# List monitor events

`GET /v1/monitors/{monitorId}/events`

## Request

- Base URL: `https://api.olostep.com`
- URL: `https://api.olostep.com/v1/monitors/{monitorId}/events`
- Auth: HTTP bearer

Retrieve the change events recorded for a monitor.

## Path parameters

- `monitorId` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `count_only` string

## Response `200`

Default Response

- object: Monitor events, or a bare count when `count_only=1`.
  - `data` object[]
    - `id` union, required
      - string
      - number
    - `run_id` string, nullable
    - `created` union
      - number
      - string
    - `changed` boolean, nullable
    - `summary` string, nullable
    - `snapshot_url` string, nullable
  - `has_more` boolean
  - `next_cursor` string, nullable
  - `total_count` number

## Other responses

- `400`: Default Response
- `401`: Default Response
- `404`: Default Response
- `502`: Default Response

---

[API](https://skmtc.dev/olostep/apis/olostep-api.md) · [All operations](https://skmtc.dev/olostep/apis/olostep-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olostep/apis/olostep-api/revisions/13c766ab100c?raw)