v1

latestSwagger 2.02026-08-0484141342.3 KB
Instances

# List Instance Scores

Returns exposure instance scores for the specified host-exposure pairs. Duplicate pairs are deduplicated server-side. Unmatched pairs are omitted from the response.

post/v1/exposures/instances/scores

Request body

Example request

{
  "filters": {
    "host_exposure_pairs": [
      {
        "exposure_id": "CVE-2022-21903",
        "hostname": "asset-001"
      }
    ]
  }
}

Response

ScoresResponse contains the list of instances for the requested host-exposure pairs.

Example response

{
  "instance_scores": [
    {
      "asset_criticality": 3.9,
      "asset_id": "asset-001",
      "contextual_cvss": 7.6,
      "cve_id": "CVE-2022-21903",
      "exploitability": 71,
      "picus_exposure_score": 7.2,
      "security_control_effectiveness": "75.0"
    }
  ]
}