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

severity
string

Filter by severity. Comma-separated; any of: critical, high, medium, low, info.

source_type
string

Filter by asset source. Comma-separated; any of: endpoint, network, external, domain.

root_cause_type
string

Filter by root-cause type. Comma-separated; any of: product, package, library, os, service, configuration, software, unknown.

patchability
string

Filter by patch availability. Comma-separated; any of: patch_available, manual_only, unknown. unknown (no patch state recorded) is a strict subset of manual_only, so /filters offers only the first two.

expand
string

Comma-separated optional expansions. tenants adds a per-tenant breakdown to each row; cves (on /assets) narrows the list to assets with at least one open finding and attaches their CVEs. Expansions cost extra reads, so ask for them only when needed.

asset_id
string

Restricts the read to a single asset. Asset identifiers are unique within a tenant, not across tenants, so tenant_ids must also be supplied; a request with asset_id and no tenant_ids is rejected with 400 asset_id_requires_tenant_ids.

Response

One page of CVEs. With expand=tenants each row also carries a per-tenant breakdown.

One cursor-paginated page of rows across the authorized tenants. Keep requesting pages, passing next_cursor as cursor, until next_cursor is null.

root_tenant_id
string<uuid>
required

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

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 rows on this page. Empty when nothing matches.