2. File Scanning


Scanning a file starts with uploading the file to MetaDefender Cloud to initiate the scan process. Although we are trying to keep scanning very fast, scanning with more than 40 engines might take from a few seconds to many minutes depending on file type, file size, and current traffic. Due to these many variables, we are not able to guarantee scanning times.

In general, free API users are sent to different queues with a lower priority, and MetaDefender Cloud customers' scan requests are prioritized.

Scanning a file consists of the following steps:

  1. Initiate scan request by uploading a file

  2. Retrieve scan report using unique data_id returned from Scan File API

If a file was already scanned before, uploading a file does not initiate a scan. Instead, it returns the latest known scan results. In other words, looking up scan results using a hash value has the same impact while using minimum network bandwidth usage. Therefore, it is strongly recommended to do "LOOK UP HASHES" before "SCAN A FILE". In order to rescan a file that was scanned before, you can initiate a rescan request using unique file_id. Please note that file_id is not available for every scan result if it was scanned via private API.

Read more about file scanning APIs: