---
title: "Read Simulation Run"
method: GET
path: "/api/v1/simulation-runs/{simulation_run_id}"
tags: ["simulation archive"]
---

# Read Simulation Run

`GET /api/v1/simulation-runs/{simulation_run_id}`

## Request

- Base URL: `https://api.brumby.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.brumby.com/api/v1/simulation-runs/{simulation_run_id}`
- Auth: HTTP bearer

## Path parameters

- `simulation_run_id` string, uuid, required

## Response `200`

Successful Response

- SimulationRunDetailResponse
  - `simulation_run_id` string, uuid, required
  - `name` string, required
  - `scenario` string, nullable, required
  - `source_format` 'replay_jsonl' | 'rosbag2' | 'ros1_bag' | 'structured_ros_logs', required
  - `storage_host_device_id` string, nullable, required
  - `source_artifact_name` string, required
  - `artifact_sha256` string, required
  - `artifact_size_bytes` integer, required
  - `manifest_sha256` string, required
  - `message_count` integer, required
  - `recorded_start_at` string, date-time, nullable, required
  - `recorded_end_at` string, date-time, nullable, required
  - `time_basis` 'source_clock' | 'relative_only', required
  - `imported_at` string, date-time, required
  - `imported_by_actor` string, required
  - `importer_version` string, required
  - `event_count` integer, required
  - `topic_summary` SimulationTopicSummary[], required
    - `topic` string, required
    - `message_count` integer, required
    - `first_observed_at` string, date-time, nullable
    - `last_observed_at` string, date-time, nullable
  - `replay_available` boolean, required
  - `replay_format` 'mcap', required
  - `replay_validation_status` 'ready' | 'ready_with_warnings' | 'invalid', required
  - `source_metadata` object, required
  - `events` SimulationRunEventResponse[], required
    - `event_id` string, uuid, required
    - `ordinal` integer, required
    - `source_topic` string, nullable, required
    - `event_kind` string, required
    - `source_observed_at` string, date-time, nullable, required
    - `source_offset_ns` integer, required
    - `summary` string, required
    - `severity` 'info' | 'warning' | 'error', required
    - `payload` object, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/brumby/apis/brumby-platform-api.md) - [All operations](https://skmtc.dev/brumby/apis/brumby-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/brumby/apis/brumby-platform-api/revisions/fe185e20813e?raw)