Skip to main content
GET
List vulnerability events for authorized partner tenants.

Authorizations

Authorization
string
header
required

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

Query Parameters

tenant_ids
string

Comma-separated tenant UUIDs to scope the list to. Omit to use every tenant the caller is authorized for.

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

OK

root_tenant_id
string<uuid>
required
from
string<date-time>
required
to
string<date-time>
required
page_size
required
next_cursor
null | string
required
coverage
object[]
required
items
object[]
required