Fetch a List of Containers in Your Account
Shows a list of containers in your account.
The maximum number of container records that can be provided by this API is 10,000.
To get container records beyond 10000, use 'Fetch a List of Containers (Bulk API)'.
Input ParametersInput Parameters
|
Parameter |
Mandatory/Optional |
Data Type |
Description |
|---|---|---|---|
|
filter |
Optional |
string |
Filter the containers list by providing a query using Qualys syntax. Refer to the “How to Search” topic in the online help for assistance with creating your query. |
|
pageNumber |
Optional |
integer |
The page to be returned. Page numbers start with 1. |
|
pageSize |
Optional |
integer |
The number of records per page to be included in the response. Valid values: 1 to 1000 The maximum limit accepted by this parameter is 1000. |
|
sort |
Optional |
string |
Sort the results using a Qualys token. For example, created:desc. Refer to the “Sortable tokens” topic in the online help for more information. |
Sample: Fetch a List of Containers in your AccountSample: Fetch a List of Containers in your Account
API request
curl -X GET
"<qualys_base_url>/csapi/v1.3/containers?pageNumber=1&pageSize=50&sort=created%3Adesc"
-H "Authorization: Bearer <token>"
Response
{
"data": [
{
"imageId": null,
"created": "1769683837000",
"updated": "1770098009055",
"sha": "22da9d9829352f0624cea9d19d87ce7455c8f33d79bec59fb17e051d9df7e86f",
"uuid": "4272d723-0ee1-35f3-a9a2-22b52fb8e9cc",
"name": "arrax",
"host": {
"sensorUuid": "e8fe235d-e9d4-0722-1c08-2ef4621c02ea",
"hostname": "ip-10-82-8-16.ec2.internal",
"ipAddress": "10.82.8.16",
"ipV6Address": null,
"uuid": null,
"lastUpdated": "2026-02-03T05:53:28.674Z"
},
"state": "UNKNOWN",
"imageUuid": null,
"containerId": "22da9d982935",
"stateChanged": "1770098008584",
"lastVmScanDate": null,
"isRoot": null,
"vulnerabilities": {
"severity5Count": null,
"severity3Count": null,
"severity4Count": null,
"severity1Count": null,
"severity2Count": null
},
"exceptions": null,
"riskScore": null,
"riskScoreCalculatedDate": null,
"formulaUsed": null,
"maxQdsScore": null,
"qdsSeverity": null,
"isExposedToWorld": false,
"scanTypes": null,
"cluster": {
"name": "surtest-ekstest",
"uid": "957e3031-c6d1-4a00-9c7e-6406e1bc3bcb"
},
"criticality": 0,
"criticalityUpdated": "1770098008904",
"vulnPropagationDate": null,
"isVulnPropagated": null,
"sensorUuid": "e8fe235d-e9d4-0722-1c08-2ef4621c02ea",
"accountQlp": "aws://eks/us-east-1/362990800442",
"clusterQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest",
"namespaceQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default",
"podQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default/arrax",
"containerQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default/arrax/arrax",
"compliance": {
"failCount": 0,
"passCount": 0,
"errorCount": 0
},
"lastComplianceScanDate": null
},
{
"imageId": null,
"created": "1768943269000",
"updated": "1770681637791",
"sha": "495712abd7cb3177b31df1ccef7a9c5dd4c8511305b912489d9cd48202c057ad",
"uuid": "f666a77c-a59c-30c3-8787-2291d95d050e",
"name": "cluster",
"host": {
"sensorUuid": "e8fe235d-e9d4-0722-1c08-2ef4621c02ea",
"hostname": "ip-10-82-60-225.ec2.internal",
"ipAddress": "10.82.60.225",
"ipV6Address": null,
"uuid": null,
"lastUpdated": "2026-02-10T00:00:23.352Z"
},
"state": "DELETED",
"imageUuid": null,
"containerId": "495712abd7cb",
"stateChanged": "1770163289858",
"lastVmScanDate": null,
"isRoot": null,
"vulnerabilities": {
"severity5Count": null,
"severity3Count": null,
"severity4Count": null,
"severity1Count": null,
"severity2Count": null
},
"exceptions": null,
"riskScore": null,
"riskScoreCalculatedDate": null,
"formulaUsed": null,
"maxQdsScore": null,
"qdsSeverity": null,
"isExposedToWorld": false,
"scanTypes": null,
"cluster": {
"name": "surtest-ekstest",
"uid": "957e3031-c6d1-4a00-9c7e-6406e1bc3bcb"
},
"criticality": 0,
"criticalityUpdated": "1770163290313",
"vulnPropagationDate": null,
"isVulnPropagated": null,
"sensorUuid": "e8fe235d-e9d4-0722-1c08-2ef4621c02ea",
"accountQlp": "aws://eks/us-east-1/362990800442",
"clusterQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest",
"namespaceQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default",
"podQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default/cluster-by-tag",
"containerQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default/cluster-by-tag/cluster",
"compliance": {
"failCount": 0,
"passCount": 0,
"errorCount": 0
},
"lastComplianceScanDate": null
},
{
"imageId": null,
"created": "1768942801000",
"updated": "1770681638944",
"sha": "152f8ffb104795393f88ea204035b76efdd1c94b4dc99043b1be265245b05892",
"uuid": "edc6f562-20ab-318d-9823-f0be5d486add",
"name": "nginx-bala",
"host": {
"sensorUuid": "e8fe235d-e9d4-0722-1c08-2ef4621c02ea",
"hostname": "ip-10-82-10-133.ec2.internal",
"ipAddress": "10.82.10.133",
"ipV6Address": null,
"uuid": null,
"lastUpdated": "2026-02-10T00:00:24.276Z"
},
"state": "DELETED",
"imageUuid": null,
"containerId": "152f8ffb1047",
"stateChanged": "1770097770849",
"lastVmScanDate": null,
"isRoot": null,
"vulnerabilities": {
"severity5Count": null,
"severity3Count": null,
"severity4Count": null,
"severity1Count": null,
"severity2Count": null
},
"exceptions": null,
"riskScore": null,
"riskScoreCalculatedDate": null,
"formulaUsed": null,
"maxQdsScore": null,
"qdsSeverity": null,
"isExposedToWorld": false,
"scanTypes": null,
"cluster": {
"name": "surtest-ekstest",
"uid": "957e3031-c6d1-4a00-9c7e-6406e1bc3bcb"
},
"criticality": 0,
"criticalityUpdated": "1770097771403",
"vulnPropagationDate": null,
"isVulnPropagated": null,
"sensorUuid": "e8fe235d-e9d4-0722-1c08-2ef4621c02ea",
"accountQlp": "aws://eks/us-east-1/362990800442",
"clusterQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest",
"namespaceQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default",
"podQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default/nginx-bala",
"containerQlp": "aws://eks/us-east-1/362990800442/surtest-ekstest/default/nginx-bala/nginx-bala",
"compliance": {
"failCount": 0,
"passCount": 0,
"errorCount": 0
},
"lastComplianceScanDate": null
}