🚧
Special privileges required
Private Scanning endpoints are only available to users with Private Scanning license.

With this endpoint you can check the status of a private file analysis. It expects the analysis ID returned by the POST /private/files endpoint, and will return a private analysis object with information about the analysis.

{
  "meta": {
    "file_info": {
      "size": 5,
      "sha256": "11a77c3d96c06974b53d7f40a577e6813739eb5c811b2a86f59038ea90add772",
      "sha1": "7bae8076a5771865123be7112468b79e9d78a640",
      "md5": "e5828c564f71fea3a12dde8bd5d27063"
    }
  },
  "data": {
    "attributes": {
      "date": 1620127014,
      "status": "completed"
    },
    "type": "private_analysis",
    "id": "ZTU4MjhjNTY0ZjcxZmVhM2ExMmRkZThiZDVkMjcwNjM6MTYyMDEyNzAxNA==",
    "links": {
      "self": "https://virustotal.com/api/v3/private/analyses/ZTU4MjhjNTY0ZjcxZmVhM2ExMmRkZThiZDVkMjcwNjM6MTYyMDEyNzAxNA=="
    }
  }
}

The status attribute in the private analysis object can be any of the following:

initializing
enqueueing
queued
running
post-processing
finished
error
retrying
unsupported file type
corrupted file
timeout
startup error
missing dependency

Once it gets completed, you can use the sha256 in the file_info section with the GET /private/files/{id} for getting all the information that VirusTotal has generated for the analysed file. Alternatively you could use GET /private/analyses/{id}/item for the same purpose.

200200

400400