Search Resources by Vulnerability and Package

Search all resources (Artifacts, Builds, Release Bundles, etc.) that include a specific package or are impacted by a specific vulnerability (CVE or XRAY ID). Supports three search modes:

  • Mode 1 - By Vulnerability: vulnerability is required.
  • Mode 2 - By Package Version: name and type are required; version is optional.
  • Mode 3 - By Package (all versions): name and type are required; omit version.

SBOM Requirement: This capability depends on the SBOM Service. Self-Hosted users must enable the SBOM feature and complete the SBOM migration. If SBOM is disabled, the API returns 403.

Pagination: Use last_key from the response to fetch subsequent pages; an empty last_key indicates no further results. Limit defaults to 1000, maximum 10000.

Requires the Reports Manager permission. Since Xray 3.131.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer

Maximum number of resources to return. Default: 1000. Maximum: 10000.

string

Pagination cursor from the previous response. Include this value to retrieve the next page.

string

Vulnerability ID in CVE format (CVE-YYYY-NNNNN) or XRAY format (XRAY-N). Required for Mode 1.

string

Package name. Required for Mode 2 and Mode 3.

string

Package type (e.g., npm, maven, pypi). Required for Mode 2 and Mode 3.

string

Package version. When provided with name and type, searches for a specific version.

string

Package namespace. Default: public.

string

Package ecosystem. Default: generic.

Body Params
Responses

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