Skip to main content
GET
Get vulnerability state for authorized partner tenants.

Authorizations

Authorization
string
header
required

A machine-client token from POST /v1/auth/client-token, carrying subject_type=machine_client and the pulse.read scope.

Scopes

pulse.read

Query Parameters

tenant_ids
string

Comma-separated tenant ids to read. Every id must be inside the caller's authorized scope, otherwise 403 tenant_out_of_scope. Omit it to read every authorized tenant.

Response

The vulnerability snapshot for the covered tenants.

A snapshot of vulnerability posture across the authorized tenants.

root_tenant_id
string<uuid>
required

The top of the caller's authorized scope.

coverage
object[]
required

The tenants the snapshot covers.

open_finding_count
required

Findings that are currently open, across all severities.

open_critical_count
required

Open findings rated critical.

open_high_count
required

Open findings rated high.

open_medium_count
required

Open findings rated medium.

open_low_count
required

Open findings rated low.

affected_asset_count
required

Assets with at least one open finding.

affected_tenant_count
required

Tenants with at least one open finding.

kev_finding_count
required

Open findings for CVEs on a known-exploited-vulnerabilities list.

exploitable_finding_count
required

Open findings with published exploit evidence.

patchable_root_cause_count
required

Root causes with open findings that a patch can fix.

remediated_30d_count
required

Findings remediated in the last 30 days.

last_detection_at
null | string<date-time>
required

When a finding was last detected, in UTC. Null when none has been.

source_tab_counts
object[]
required

The open findings split by how the asset is scanned.

lifecycle_series
object[]
required

Findings opened, remediated and still open, one point per day.