PIpicussecurity
Apv

# List APV Simulations

Changed on

Lists Attack Path Validation simulations for the account. Used to discover the simulation_uuid/run_uuid pairs needed by the run-scoped endpoints.

get/v1/apv/simulations

Request

Query parameters

limitinteger
offsetinteger
name_likestring

Filter by simulation name (partial match)

statusstring[]

Filter by status (comma-separated): WAITING | INITIALIZING | RUNNING | POSTPROCESSING | COMPLETED | STOPPED | FAILED | ACHIEVED | WAITING FOR THE FIRST RUN | NOT STARTED

simulation_typestring[]

Filter by simulation type (comma-separated): GRAY_BOX | RED_TEAM | BLACK_BOX | DOMAIN_ADMIN | RANSOMWARE

Response

SimulationListResponseSwagger

Example response

{
  "pages": {
    "limit": 20,
    "total_count": 100
  },
  "simulations": [
    {
      "created_at": 1751360400000,
      "created_by": "user@domain.com",
      "last_run_time": 1751362320000,
      "name": "Q3 Gray-Box Simulation",
      "run_uuid": "r9y8x7w6-0000-0000-0000-000000000002",
      "simulation_uuid": "a1b2c3d4-0000-0000-0000-000000000001",
      "status": "COMPLETED"
    }
  ]
}

Changes