Get Vulnerabilities by RQL
POST/uve/api/v1/vulnerabilities/search
Get the list of vulnerabilities and their details based on an RQL query. For vulnerability RQL query attributes, see Vulnerability Query Attributes. For example queries, see Vulnerability Query Examples.
To download all the vulnerabilities by RQL in a CSV format, see Download All Vulnerabilities by RQL
Note: You need
investigateVulnerabilityRql
feature withView
permission to access this endpoint. Verify if your permission group includes this feature using the Get Permission Group by ID endpoint. You can also check this in the Prisma Cloud console by ensuring that Investigate > Vulnerability is enabled.
Request
Query Parameters
Token for pagination
Possible values: [asset
, cve
]
Filter vulnerabilities based on the CVE or Asset view as available in the UI. cve is used to get details of the CVEs that matches the query and asset is used to get the details of the assets that have the CVE which matches the query.
- application/json
Body
Vulnerability Query to Search
saved search ID
Responses
- 200
- 202
- 400
- 401
- 403
- 429
- 500
successful operation
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
timeRange object
data object
items object[]
code object
packages object
iacResources object
build object
images object
functions object
deploy object
registryImages object
hostVmImages object
run object
deployedImages object
functions object
hosts object
assetSearchResultData object
items object[]
severityCount object
{
"id": "string",
"name": "string",
"description": "string",
"searchType": "string",
"saved": true,
"timeRange": {
"type": "string",
"value": "string"
},
"query": "string",
"data": {
"totalRows": 0,
"totalAssets": 0,
"totalVulnerabilities": 0,
"items": [
{
"cveId": "string",
"name": "string",
"cvssScore": 0,
"epssScore": 0,
"epssScorePrevious": 0,
"completeEpssScore": 0,
"totalImpactedAssets": 0,
"riskFactors": [
"string"
],
"code": {
"assetsCount": 0,
"packages": {
"packageCount": 0,
"repositoryCount": 0
},
"iacResources": {
"iacResourcesCount": 0,
"repositoryCount": 0
}
},
"build": {
"assetsCount": 0,
"images": {
"imagesCount": 0,
"pipelineCount": 0
},
"functions": {
"functionsCount": 0,
"pipelineCount": 0
}
},
"deploy": {
"assetsCount": 0,
"registryImages": {
"registryImagesCount": 0,
"repositoryCount": 0
},
"hostVmImages": {
"hostVmImagesCount": 0
}
},
"run": {
"assetsCount": 0,
"deployedImages": {
"deployedImagesCount": 0,
"containerCount": 0
},
"functions": {
"functionsCount": 0
},
"hosts": {
"hostsCount": 0
}
},
"published": 0,
"exploitable": true,
"patchable": true,
"severity": "string"
}
],
"nextPageToken": "string"
},
"assetSearchResultData": {
"totalAssets": 0,
"totalRows": 0,
"items": [
{
"unifiedAssetId": "string",
"assetType": "string",
"assetName": "string",
"cloudAccount": "string",
"c2cFixSource": "string",
"registryName": "string",
"internetExposed": true,
"packageInUse": true,
"application": "string",
"owner": "string",
"spId": "string",
"severityCount": {
"lowSeverityCount": 0,
"mediumSeverityCount": 0,
"highSeverityCount": 0,
"criticalSeverityCount": 0
},
"repoName": "string",
"clusterName": [
"string"
],
"clusterNamespaces": [
"string"
]
}
],
"nextPageToken": "string"
}
}
Successfully returned the response for the request
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
- Array [
- ]
timeRange object
data object
items object[]
code object
packages object
iacResources object
build object
images object
functions object
deploy object
registryImages object
hostVmImages object
run object
deployedImages object
functions object
hosts object
assetSearchResultData object
items object[]
severityCount object
{
"id": "string",
"name": "string",
"description": "string",
"searchType": "string",
"saved": true,
"timeRange": {
"type": "string",
"value": "string"
},
"query": "string",
"data": {
"totalRows": 0,
"totalAssets": 0,
"totalVulnerabilities": 0,
"items": [
{
"cveId": "string",
"name": "string",
"cvssScore": 0,
"epssScore": 0,
"epssScorePrevious": 0,
"completeEpssScore": 0,
"totalImpactedAssets": 0,
"riskFactors": [
"string"
],
"code": {
"assetsCount": 0,
"packages": {
"packageCount": 0,
"repositoryCount": 0
},
"iacResources": {
"iacResourcesCount": 0,
"repositoryCount": 0
}
},
"build": {
"assetsCount": 0,
"images": {
"imagesCount": 0,
"pipelineCount": 0
},
"functions": {
"functionsCount": 0,
"pipelineCount": 0
}
},
"deploy": {
"assetsCount": 0,
"registryImages": {
"registryImagesCount": 0,
"repositoryCount": 0
},
"hostVmImages": {
"hostVmImagesCount": 0
}
},
"run": {
"assetsCount": 0,
"deployedImages": {
"deployedImagesCount": 0,
"containerCount": 0
},
"functions": {
"functionsCount": 0
},
"hosts": {
"hostsCount": 0
}
},
"published": 0,
"exploitable": true,
"patchable": true,
"severity": "string"
}
],
"nextPageToken": "string"
},
"assetSearchResultData": {
"totalAssets": 0,
"totalRows": 0,
"items": [
{
"unifiedAssetId": "string",
"assetType": "string",
"assetName": "string",
"cloudAccount": "string",
"c2cFixSource": "string",
"registryName": "string",
"internetExposed": true,
"packageInUse": true,
"application": "string",
"owner": "string",
"spId": "string",
"severityCount": {
"lowSeverityCount": 0,
"mediumSeverityCount": 0,
"highSeverityCount": 0,
"criticalSeverityCount": 0
},
"repoName": "string",
"clusterName": [
"string"
],
"clusterNamespaces": [
"string"
]
}
],
"nextPageToken": "string"
}
}
Bad request
- application/json
- Schema
- Example (from schema)
Schema
{
"code": "string",
"message": "string",
"target": "string"
}
Unauthorized Access
- application/json
- Schema
- Example (from schema)
Schema
{
"code": "string",
"message": "string",
"target": "string"
}
User Doesn't have role to access
- application/json
- Schema
- Example (from schema)
Schema
{
"code": "string",
"message": "string",
"target": "string"
}
Rate Limit Exceeded
- application/json
- Schema
- Example (from schema)
Schema
{
"code": "string",
"message": "string",
"target": "string"
}
Failed with an Exception, Internal Error Occurred
- application/json
- Schema
- Example (from schema)
Schema
{
"code": "string",
"message": "string",
"target": "string"
}