Skip to Content
veriom

Finding risk summary

GET
/v1/workspaces/{workspace_id}/findings/summary

Authorization

workspaceToken
headerAuthorizationBearer <vat_<opaque-token>>

Expiring, hashed workspace token with explicit scopes.

Path Parameters

workspace_id*Workspace Id
Formatuuid

Query Parameters

repository_id?|null
owner?||null
lifecycle_state?|null
first_seen_after?|null
first_seen_before?|null
structural_layer?|null
severity?|null
status?|null
architecture_disposition?||

The architecture view to count. default is the view the findings list opens on: confirmed architecture impact (actionable), or needs_review when nothing is confirmed and observations await review. With finding_group=architectural it is every architectural finding, which the impact review does not assess. The response names the view.

Default"actionable"
finding_group?|

Only one Findings group: security (what a scanner reported) or architectural (what the architecture analysis reported).

Response Body

Successful Response

application/json
  1. response
active_findings*Active Findings

Open findings: new, confirmed, in remediation or reopened. Fixed, false-positive and accepted-risk findings are not open. The risk scores and severity counts cover these.

Range0 <= value
architecture_disposition?Architecture Disposition

The architecture view these counts cover. Asking for the default view reads the one the findings list opens on: confirmed architecture impact, or the findings awaiting architecture review when nothing is confirmed.

Default"actionable"
Value in"actionable""all""pending""architecturally_relevant""not_architecturally_relevant""needs_review"
awaiting_review?Awaiting Review

Open findings that still need an architecture review, under the same filters whatever view the other counts cover.

Range0 <= value
Default0
deduplication_method*Deduplication Method
global_risk_score*Global Risk Score
highest_risk_score*Highest Risk Score
scoring_method*Scoring Method
scoring_version?Scoring Version
Default"risk-v1"
severity_counts*
unique_findings*Unique Findings
Range0 <= value
Example Request
curl -X GET 'https://api.veriom.ai/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/findings/summary'
Example Response
{  "active_findings": 0,  "architecture_disposition": "actionable",  "awaiting_review": 0,  "deduplication_method": "string",  "global_risk_score": "string",  "highest_risk_score": "string",  "scoring_method": "string",  "scoring_version": "risk-v1",  "severity_counts": {    "property1": 0,    "property2": 0  },  "unique_findings": 0}