Malware Scanning

Job request to perform a Malware Scan on files.

Input

Clients must provide a URL in the "i" tag field. The desired file(s) to be scanned must be directly accessible at the provided URL.

Output

If no malware was found, content is set to the string CLEAN. If malware was found, content contains plaintext with details of findings.

Example 1

Analysis of a file that contains malware.

Request

{
  "content": "",
  "kind": 5500,
  "tags": [["i", "https://secure.eicar.org/eicar.com.txt", "url"]]
}

Response

{
  ...
  "content": "Scanning eicar.com.txt
eicar.com.txt: Win.Test.EICAR_HDB-1 FOUND
eicar.com.txt: Win.Test.EICAR_HSB-1 FOUND
eicar.com.txt: Eicar-Signature FOUND
eicar.com.txt!(0): Eicar-Signature FOUND

----------- SCAN SUMMARY -----------
Known viruses: 8682629
Engine version: 1.2.1
Scanned directories: 0
Scanned files: 1
Infected files: 1
Data scanned: 0.00 MB
Data read: 0.00 MB (ratio 0.00:1)
Time: 12.757 sec (0 m 12 s)
Start Date: 2024:01:15 17:01:38
End Date:   2024:01:15 17:01:51",
  "kind": 6500
  ...
}

Example 2

Analysis of a clean file.

Request

{
  "content": "",
  "kind": 5500,
  "tags": [
    [
      "i",
      "https://raw.githubusercontent.com/ca110us/go-clamav/main/example/test_file/nmap",
      "url"
    ]
  ]
}

Response

{
  ...
  "content": "CLEAN",
  "kind": 6500
  ...
}