External DocumentationTo learn more, visit the VirusTotal documentation.
Basic Parameters
| Parameter | Description |
|---|---|
| File Hash | The SHA-256, SHA-1 or MD5 identifying the file. |
| Return All Pages | Automatically fetch all resources, page by page. |
Advanced Parameters
| Parameter | Description |
|---|---|
| Cursor | A pagination token that indicates which page the next set of results. When included in the response, this cursor means additional items exist in subsequent pages. |
| Limit | The maximum number of items to get. |
Example Output
{
"data": [
{
"id": "f-9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08-fb41baac",
"type": "comment",
"links": {
"self": "https://mock-api.example.com/v3/comments/mock-comment-id-1"
},
"attributes": {
"html": "Verdict: Clean<br />Score: 0/100<br /><br />File Type: Text<br />File Size: 4.00 Bytes (4 bytes)<br />Packer: WREQ<br /><br /><strong>File Report</strong><br />https://mock.example.com/file/mock-file-id-1 <br /><br />Content: https://mock.example.com/file/mock-file-id-1/content<br />Download: https://mock.example.com/file/mock-file-id-1/download",
"votes": {
"positive": 0,
"negative": 0,
"abuse": 0
},
"text": "Verdict: Clean\nScore: 0/100\n\nFile Type: Text\nFile Size: 4.00 Bytes (4 bytes)\nPacker: WREQ\n\n[b]File Report[/b]\nhttps://mock.example.com/file/mock-file-id-1 \n\nContent: https://mock.example.com/file/mock-file-id-1/content\nDownload: https://mock.example.com/file/mock-file-id-1/download",
"date": 1726952761,
"tags": []
}
},
{
"id": "f-9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08-411213c3",
"type": "comment",
"links": {
"self": "https://mock-api.example.com/v3/comments/mock-comment-id-2"
},
"attributes": {
"html": "Joe Sandbox Analysis: <br />\t\t\t<br />Verdict: CLEAN<br />Score: 0/100<br /><br />HTML Report: https://mock.example.com/analysis/mock-analysis-1/html\t<br />PDF Report: https://mock.example.com/analysis/mock-analysis-1/pdf<br />Executive Report: https://mock.example.com/analysis/mock-analysis-1/executive<br />Incident Report: https://mock.example.com/analysis/mock-analysis-1/irxml<br />IOCs: https://mock.example.com/analysis/mock-analysis-1",
"votes": {
"positive": 0,
"negative": 0,
"abuse": 0
},
"text": "Joe Sandbox Analysis: \n\t\t\t\nVerdict: CLEAN\nScore: 0/100\n\nHTML Report: https://mock.example.com/analysis/mock-analysis-1/html\t\nPDF Report: https://mock.example.com/analysis/mock-analysis-1/pdf\nExecutive Report: https://mock.example.com/analysis/mock-analysis-1/executive\nIncident Report: https://mock.example.com/analysis/mock-analysis-1/irxml\nIOCs: https://mock.example.com/analysis/mock-analysis-1",
"date": 1721021469,
"tags": []
}
}
],
"meta": {
"count": 27,
"cursor": "CtIBChEKBGRhdGUSCQjlyZHU7M75AhK4AWoRc352aXJ1c3RvdGFsY2xvdWRyogELEgZTYW1wbGUiQDlmODZkMDgxODg0YzdkNjU5YTJmZWFhMGM1NWFkMDE1YTNiZjRmMWIyYjBiODIyY2QxNWQ2YzE1YjBmMDBhMDgMCxIHQ29tbWVudCJJOWY4NmQwODE4ODRjN2Q2NTlhMmZlYWEwYzU1YWQwMTVhM2JmNGYxYjJiMGI4MjJjZDE1ZDZjMTViMGYwMGEwOC02NTI5ZmFlZAwYACAB"
},
"links": {
"self": "https://mock-api.example.com/v3/files/mock-file-id-1/comments?limit=10",
"next": "https://mock-api.example.com/v3/files/mock-file-id-1/comments?limit=10&cursor=mock-cursor-1"
}
}
Workflow Library Example
Get File Comments with Virustotal and Send Results Via Email