Skip to main content
GET
Get vulnerability trend series 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.

range
enum<string>

The number of days of history: 30 (the default), 60 or 90. Anything else returns 400 invalid_range.

Available options:
30,
60,
90

Response

One daily series per covered tenant.

A vulnerability trend per tenant: one point per day over the requested range.

root_tenant_id
string<uuid>
required

The top of the caller's authorized scope.

range_days
required

The number of days of history returned: 30, 60 or 90.

coverage
object[]
required

The tenants the series were read from.

tenants
object[]
required

One series per tenant read.