get
https://api.picussecurity.com/v1/apv/simulations//runs//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
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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
}
}