Fetch Container Details

Parameter	Mandatory/Optional	Data Type	Description
containerSha	Mandatory	string	Specify the SHA value of a specific container in the user’s scope.

API request

    curl -X "GET"
"<qualys_base_url>/csapi/v1.3/containers/647ae732d98e1bcceb7b02356bd7e873eef13c5916c3a1e9d95700ab893cc09f"
-H "accept: application/json"
-H "Authorization: Bearer <token>"  
    

Response

  {
  "portMapping": null,
  "imageId": null,
  "created": "1768942801000",
  "updated": "1770681638944",
  "label": null,
  "uuid": "edc6f562-20ab-318d-9823-f0be5d486add",
  "sha": "152f8ffb104795393f88ea204035b76efdd1c94b4dc99043b1be265245b05892",
  "privileged": false,
  "path": null,
  "imageSha": null,
  "imageDigest": "c881927c4077710ac4b1da63b83aa163937fb47457950c267d92f7e4dedf4aec",
  "macAddress": null,
  "customerUuid": "7d80136c-2f05-4d22-8076-4af283a03921",
  "ipv4": "10.82.8.31",
  "ipv6": null,
  "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"
  },
  "hostArchitecture": [
    "amd64"
  ],
  "state": "DELETED",
  "imageUuid": null,
  "containerId": "152f8ffb1047",
  "stateChanged": "1770097770849",
  "services": null,
  "users": null,
  "operatingSystem": null,
  "lastScanned": null,
  "source": "CLUSTER",
  "sources": [
    "CLUSTER"
  ],
  "riskScore": null,
  "riskScoreCalculatedDate": null,
  "formulaUsed": null,
  "maxQdsScore": null,
  "qdsSeverity": null,
  "scanTypes": null,
  "criticality": 0,
  "criticalityUpdated": "1770097771403",
  "isVulnPropagated": null,
  "vulnPropagationDate": 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",
  "environment": null,
  "arguments": null,
  "command": "null",
  "drift": null,
  "vulnerabilities": [],
  "softwares": null,
  "isDrift": false,
  "isRoot": null,
  "lastComplianceScanned": null,
  "cluster": {
    "type": "KUBERNETES",
    "name": "surtest-ekstest",
    "uid": "957e3031-c6d1-4a00-9c7e-6406e1bc3bcb",
    "version": null,
    "k8s": {
      "project": null,
      "pod": {
        "name": "nginx-bala",
        "uuid": "84b30a9c-364d-4b5a-b1b5-a09e3db402e3",
        "namespace": "default",
        "namespaceMetadata": null,
        "label": null,
        "controller": null
      },
      "node": {
        "name": "ip-10-82-10-133.ec2.internal",
        "isMaster": false
      }
    }
  },
  "cloudProvider": {
    "aws.ecs.container.subnetId": null,
    "aws.eks.accountId": "362990800442",
    "aws.ecs.clusterName": null,
    "aws.ecs.container.macAddress": null,
    "aws.ecs.region.code": null,
    "aws.ecs.container.id": null,
    "aws.ecs.accountId": null,
    "aws.eks.arn": "arn:aws:eks:us-east-1:362990800442:cluster/surtest-ekstest",
    "aws.eks.region": "us-east-1"
  },
  "exceptions": null,
  "k8sExposure": null
}

Error Response

The following error response is seen when the sub-users don't have permission to the specified containerSha.

    {  
    "errorCode": "403 FORBIDDEN",  
    "message": "Request Forbidden",  
    "timestamp": 1700721586546
    } 

This sample includes container details for AWS Fargate. Therefore, you’ll see the source value as “SERVERLESS_FARGATE” and the AWS ECS cloudProvider fields in the response.

API request

    curl -X "GET"
"<qualys_base_url>/csapi/v1.3/containers/e39c5d55eb8638699f1099c5bd1527df1268aeef3628124e5a9ed6133fb03bba"
-H "accept: application/json" 
-H "Authorization: Bearer <token>"
    

Response

    {
    "portMapping": null,
    "imageId": "544d56423393",
    "created": "1685526156673",
    "updated": "1685526276307",
    "label": null,
    "uuid": "8946efb6-9f63-3b24-a4eb-1bb1285db496",
    "sha": "e39c5d55eb8638699f1099c5bd1527df1268aeef3628124e5a9ed6133fb03bba",
    "privileged": false,
    "path": null,
    "imageSha": "544d56423393b9eceacb196ea0a043f5940689269a6a6fcc9387a8b9b14f3fcc",
    "macAddress": null,
    "customerUuid": "6a849349-679f-ef25-8296-e51d4e3a0019",
    "ipv4": null,
    "ipv6": null,
    "name": "wordpress_php80",
    "host": null,
    "hostArchitecture": null,
    "state": "STOPPED",
    "imageUuid": "eb82a38d-5ed1-3852-a092-58b24380d011",
    "containerId": "e39c5d55eb86",
    "stateChanged": "1685526157920",
    "services": null,
    "users": null,
    "operatingSystem": null,
    "lastScanned": null,
    "source": "SERVERLESS_FARGATE",
    "riskScore": null,
    "riskScoreCalculatedDate": null,
    "formulaUsed": null,
    "maxQdsScore": null,
    "qdsSeverity": null,
    "scanTypes": null,
    "criticality": null,
    "criticalityUpdated": null,
    "vulnPropagationDate": "1743148605300",  
    "isVulnPropagated": true,
    "sensorUuid": "197ddd8b-d4d2-4821-bf73-005347bc933a",
    "environment": null,
    "arguments": null,
    "command": null,
    "drift": null,
    "vulnerabilities": [],
    "softwares": null,
    "isDrift": false,
    "isRoot": null,
    "lastComplianceScanned": null,
    "cluster":{
    "type": "KUBERNETES",
    "k8s": {
      "project": null,
      "pod": {
        "name": "spring-1",
        "uuid": "4a7d3fc3-de97-44eb-85d3-5f661a175337",
        "namespace": "default",
        "namespaceMetadata": {
          "labels": [
            "kubernetes.io/metadata.name:default"
          ],
          "annotations": [
            "kubernetes.io/metadata.name:test",
            "kubernetes.io/metadata.name:default"
          ]
        },
    "cloudProvider": {
        "aws.ecs.container.subnetId": "subnet-073576bdd0261adda",
        "aws.ecs.clusterName": "jack-explore",
        "aws.ecs.container.macAddress": "06:**:4*:*0:**:45",
        "aws.ecs.region.code": "us-west-2",
        "aws.ecs.container.id": "1292cfce-301f-4817-a86f-8da65d431e3b",
        "aws.ecs.accountId": "36******0442"
    }
    "exceptions": [
    {
     "uuid": "624efd86-6172-4851-beb1-75cb9b1634fb",
     "assignmentType": "CASCADE"
    },
    {
    "riskScore": 258,
    "riskScoreCalculatedDate": "1722355883371",
    "formulaUsed": "MIN (1000 , 2 * ( 1.0 * 64.70 * Pow(10,0.01) + 0.6 *60.04 * Pow(26,0.01) + 0.4 * 44.35 * Pow(147,0.01) + 0.2 *36.20*Pow(5,0.01) ))",
    "maxQdsScore": 87,
    "qdsSeverity": "CRITICAL"
    "criticality": 3,
    "criticalityUpdated": 1717098843553,
    }
    ]
}

Error Response 

The following error response will be seen when the sub-users don't have permission to the specified containerSha.

    {  
    "errorCode": "403 FORBIDDEN",  
    "message": "Request Forbidden",  
    "timestamp": 1700721586546
    }