---
title: "Get a monitor run"
method: GET
path: "/v1/monitors/{monitorId}/runs/{runId}"
tags: ["monitors"]
---

# Get a monitor run

`GET /v1/monitors/{monitorId}/runs/{runId}`

## Request

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

Retrieve a single run (snapshot) of a monitor.

## Path parameters

- `monitorId` string, required
- `runId` string, required

## Response `200`

Default Response

- object: A single monitor run.
  - `monitor_id` string, required
  - `run_id` string, required
  - `snapshot` object, nullable
  - `log_group` string, nullable
  - `events` object: The execution result, as the worker stored it.
  - `snapshot_payload` object, nullable
  - `olostep_tool` object, nullable
    - `object` string, required
    - `id` string, required

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