# Run Summary

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

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

About

Returns the summary of a finished simulation run (status, duration, action count, initial access machine, initiator and schedule); works only once the run is Completed, Stopped or Failed.


Example

Get the summary of run {run_uuid} of simulation {simulation_uuid}.

curl --request GET \
     --url https://api.picussecurity.com/v1/apv/simulations/{simulation_uuid}/runs/{run_uuid}/summary \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer access_token'
{
  "overview": {
    "opening": "The simulation started from WS-FIN-01 with standard user privileges.",
    "scope": "The simulation targeted the 10.0.0.0/24 network in the corp.local domain.",
    "actions": {
      "discovery": "Domain users, groups and reachable hosts were enumerated.",
      "credential_access": "Credentials were dumped from LSASS memory.",
      "privilege_escalation": "Domain admin privileges were obtained with the dumped credentials.",
      "lateral_movement": "The attacker moved laterally to the domain controller using Pass-the-Hash."
    },
    "closing": "The simulated attacker compromised a domain controller."
  },
  "schedule": {
    "day_of_week": [1, 3, 4],
    "frequency": "WEEKLY",
    "frequency_interval": 1,
    "next_run": 1751965200000,
    "start_time": 1751360400000
  },
  "simulation_result": {
    "achieved": true,
    "description": "The simulated attacker compromised a domain controller."
  },
  "summary": {
    "actions": 42,
    "created_at": 1751360400000,
    "created_by": "[email protected]",
    "duration": 1920,
    "enabled_opc": true,
    "initial_access_machine": "WS-FIN-01",
    "initiator": {
      "id": 102,
      "name": "LNX-AGENT-02",
      "type": "LINUX_AGENT"
    },
    "simulation_name": "Q3 Gray-Box Simulation",
    "simulation_type": "GRAY_BOX",
    "status": "COMPLETED",
    "timeout": 3600
  }
}
Path Params
string
required

Simulation UUID

string
required

Run UUID

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json