Skip to main content
GET
Export vulnerability events 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.

from
string

Start of the detection window, an ISO 8601 timestamp, treated as UTC. Defaults to 24 hours before to. Must not be later than to.

to
string

End of the detection window, an ISO 8601 timestamp, treated as UTC. Defaults to now.

format
enum<string>

The export format. Only json is supported; anything else returns 400 unsupported_export_format.

Available options:
json

Response

A page of detection events, sent as an attachment named pulse-vulnerability-events-<timestamp>.json.

A single page of live vulnerability detection events for download, capped at 500 events and not paginated. Sent with a Content-Disposition: attachment header.

root_tenant_id
string<uuid>
required

The top of the caller's authorized scope.

generated_at
string<date-time>
required

When the export was produced, in UTC.

from
string<date-time>
required

Start of the detection window, in UTC.

to
string<date-time>
required

End of the detection window, in UTC.

format
string
required

The export format. Always json.

coverage
object[]
required

The tenants the events were read from.

items
object[]
required

The detection events, at most 500.