Asset Scores
Enterprise

Get zone protected asset score

Changed on

Gets a per-day series describing how much of a zone is free of open findings over the requested time range. For each day in the range, the score is the number of objects in the zone without an open finding divided by the total number of objects in the zone. Zones that attack path analysis does not run against yield an empty series.

get/api/v2/asset-scores/zone-protected-asset-score

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/asset-scores/zone-protected-asset-score
  • Auth: one of:
    • HTTP bearer
    • API key in header Authorization and API key in header RequestDate and API key in header Signature

Query parameters

environmentsstring[] required

Environment IDs

asset_group_tag_idinteger required

The asset group tag id of the zone requested

startstring date-time

Beginning datetime of range (inclusive) in RFC-3339 format; Defaults to current datetime minus 30 days

endstring date-time

Ending datetime of range (exclusive) in RFC-3339 format; Defaults to current datetime

Response

OK

Changes