List customers with per-instance CVE exposure.

Return a paginated, customer-centric view of CVE exposure. Customers are
first selected when an instance's latest reported downstream release has
a matching release-image CVE posture. All instances for selected customers
are then returned with per-instance CVE
counts sourced from SDK-reported running images and per-customer aggregate
counts (the element-wise max across instances with data, null when none has
data). Airgap instances without SDK
reporting are returned only when another instance selects their customer;
they carry the license channel's latest-release CVE posture as context.
The severity filter accepts a set (repeatable and/or comma-separated) and
keeps customers with at least one CVE in any selected severity; customers
without CVE data are excluded while a severity filter is active. Counts
in the response always cover all four severities. Requires the Security
Center team feature; teams without it receive 403.

Required RBAC Policy: kots/app/[:appid]/license/[:licenseid]/read

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

App identifier

Query Params
int64
Defaults to 20

Page size

int64

Current page

string

Customer search term, resolved through the same OpenSearch-backed engine
as POST /customers/search and supporting its exact query syntax: a bare
term is a fuzzy/prefix name match; name:, type:, channels.name:,
customId:, email:, and airgap: prefixes target specific fields.

severity
array of strings

One or more severities (critical, high, medium, low) to filter customers
by; repeatable and/or comma-separated. A customer is included when it has
at least one CVE in any selected severity. Empty means no filtering.

severity
boolean

Include unfixable CVEs in counts (default false)

string

Sort order: customer_name, critical_cves, total_cves, or instance_count
(default critical_cves)

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json