---
title: "# Run Summary"
method: GET
path: "/v1/apv/simulations/{simulationUuid}/runs/{runUuid}/summary"
tags: ["Apv"]
---

# # Run Summary

`GET /v1/apv/simulations/{simulationUuid}/runs/{runUuid}/summary`

## Request

- Base URL: `https://api.picussecurity.com`
- URL: `https://api.picussecurity.com/v1/apv/simulations/{simulationUuid}/runs/{runUuid}/summary`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/picussecurity/apis/picus-rest-api/docs/v1/apv/simulations/:simulationUuid/runs/:runUuid/summary/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches the summary data for a run. Errors unless the run is Completed, Stopped, or Failed.

## Path parameters

- `simulationUuid` string, required
- `runUuid` string, required

## Response `200`

RunSummaryResponseSwagger

- ApvRunSummaryOutput
  - `overview` ApvOverview
    - `actions` ApvOverviewActions
      - `credential_access` string
      - `discovery` string
      - `lateral_movement` string
      - `privilege_escalation` string
    - `closing` string
    - `opening` string
    - `scope` string
  - `schedule` ApvRunSchedule
    - `day_of_week` integer[]
    - `frequency` string
    - `frequency_interval` integer
    - `next_run` integer: Epoch milliseconds.
    - `start_time` integer: Epoch milliseconds.
  - `simulation_result` ApvSimulationResult
    - `achieved` boolean
    - `description` string
  - `summary` ApvRunSummary
    - `actions` integer
    - `created_at` integer: Epoch milliseconds.
    - `created_by` string
    - `duration` integer
    - `enabled_opc` boolean
    - `initial_access_machine` string
    - `initiator` ApvRunInitiator
      - `id` integer
      - `name` string
      - `type` string
    - `simulation_name` string
    - `simulation_type` string
    - `status` string
    - `timeout` integer

## Other responses

- `401`: unauthorizedErrorSwagger is represents unauthorized error
- `422`: validationErrorSwagger is represents the erroneous cases
- `default`: genericErrorSwagger is represents the erroneous cases

## Changes

- **2026-10-13** `da387004d99b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/picussecurity/apis/picus-rest-api/changes/v1/apv/simulations/:simulationUuid/runs/:runUuid/summary/get.md)

---

[API](https://skmtc.dev/picussecurity/apis/picus-rest-api.md) - [All operations](https://skmtc.dev/picussecurity/apis/picus-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/picussecurity/apis/picus-rest-api/revisions/da387004d99b?raw)