Skip to main content
GET
List 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.

include_descendants
enum<string>

When true, widens each id in tenant_ids to that tenant and every tenant beneath it in the hierarchy. Ignored when tenant_ids is omitted, since the default is already the caller's whole scope.

Available options:
true,
false
from
string

Start of the window, RFC 3339. Treated as UTC.

to
string

End of the window, RFC 3339. Treated as UTC.

page_size
string

Maximum number of items per page.

cursor
string

Opaque pagination cursor: pass the previous response's next_cursor to fetch the next page.

Response

One page of detection events, newest first.

One cursor-paginated page of live vulnerability detection events inside the requested window, newest first.

root_tenant_id
string<uuid>
required

The top of the caller's authorized scope: the tenant the access token was issued for.

from
string<date-time>
required

Start of the detection window, in UTC. The default is 24 hours before to.

to
string<date-time>
required

End of the detection window, in UTC. The default is the time of the request.

page_size
required

The number of rows this page was limited to: the page_size you asked for, or the default.

next_cursor
null | string
required

Opaque cursor for the next page: send it back as cursor. Null on the last page.

coverage
object[]
required

The tenants this response was read from, after tenant_ids and include_descendants were applied. A tenant with no rows still appears here.

items
object[]
required

The detection events on this page. Empty when nothing was detected in the window.