Request a file rescan (re-analyse)

🚧

IoC scanning and dataset inclusion

Any IoC submitted or queried via the API will be scanned and added to the Google Threat Intelligence dataset, making it accessible to the community. Do not submit or query indicators containing sensitive, confidential, or personally identifiable information (PII).

❗️

Caution

This API endpoint has the potential to produce a denial of service on the scanning infrastructure if abused. Please contact us if you are going to be rescanning more than 50K files per day.

Files that have been already uploaded to Google TI can be re-analysed without uploading them again, you can use this endpoint for that purpose. The response is an object descriptor for the new analysis as in the POST /files endpoint. The ID contained in the descriptor can be used with the GET /analyses/{id} endpoint to get information about the analysis.

{
  "data": {
    "type": "analysis",
    "id": "NjY0MjRlOTFjMDIyYTkyNWM0NjU2NWQzYWNlMzFmZmI6MTQ3NTA0ODI3Nw=="
  }
}

Re-analysing Password-Protected Files

When re-analysing a password-protected archive or encrypted document, you can pass the optional password query parameter (a UTF-8 string up to 128 characters). Google TI uses the password to decompress and index the bundled_files and analyze the sample in supported dynamic analysis sandboxes:

curl --request POST \
     --url "https://www.virustotal.com/api/v3/files/{id}/analyse?password=infected" \
     --header "x-apikey: YOUR_API_KEY" \
     --header "accept: application/json"
Path Params
string
required

SHA-256, SHA-1 or MD5 identifying the file

Query Params
string

Optional password (up to 128 UTF-8 characters) to decrypt password-protected archives (ZIP, 7z, RAR) and encrypted documents (PDF, Office), extract bundled inner files, and analyze them in supported dynamic analysis sandboxes.

Headers
string
required

Your API key

Responses

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