Gets threat history information for a given endpoint.
GET {{baseUrl}}/api/console/gsm/:gsmKey/sites/:siteId/endpoints/:endpointId/threathistory?startDate=2022-10-30T10:36:04.4660864Z&endDate=2022-11-29T10:36:04.4660864Z&returnedInfo=ExtendedInfo&pageSize=50&pageNr=1
NOTE: The maximum allowed time difference between 'startDate' and 'endDate' is 3 calendar months.
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
startDate | string | If specified, returns all threat history records after (or at) the given date. If omitted, defaults to 'endDate' minus 24 hours. | |
endDate | string | If specified, returns all threat history records before (or at) the given date. If omitted, defaults to the current date and time. | |
returnedInfo | string | A comma separated list of classes of information to be provided in response data. Currently only the "ExtendedInfo" class is supported as a value. If omitted, general threat record information is returned only. | |
pageSize | number | Specifies the number of records to return. | |
pageNr | number | Specifies the page number. Can be used to retrieve the next batch of records. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"MoreAvailable":false,"PageNr":1,"PageSize":50,"StartDate":"2022-08-29T10:36:04.4660864Z","EndDate":"2022-11-29T10:36:04.4660864Z","ThreatRecords":[{"EndpointId":"4e5f81e3-a32a-48de-9998-e5e5c76009da","MachineId":"3550320D2AD4486C8506E3AE0E116669:::4008C7B0CEAF4BB4AB571CAB6BD39AC0:::4008C7B0CEAF4BB4AB571CAB6BD39AC0","HostName":"MyComputer1","FileName":"eicar.com","PathName":"?:\\users\\user1\\desktop","MalwareGroup":"Anti-Malware Testfile","FirstSeen":"2022-11-16T10:36:04.4660864Z","LastSeen":"2022-11-27T10:36:04.4660864Z","ExtendedInfo":{"DwellTime":788,"FileMD5":"6F21795CDBF14899BD26910935363C47","FileSize":68,"UserName":"User1","IPAddress":"95.48.167.31","Determination":"B","FileVendor":"","FileProduct":"","FileVersion":""}},{"EndpointId":"2f02754e-a813-41fe-92a3-28f86e6dc2a0","MachineId":"431BD4D88163487BACBB5C096DD3D775:::600D81879B7143539F2A7264A0D0AFAF:::600D81879B7143539F2A7264A0D0AFAF","HostName":"MyComputer2","FileName":"eicar.com","PathName":"?:\\users\\user2\\desktop","MalwareGroup":"Anti-Malware Testfile","FirstSeen":"2022-11-16T10:36:04.4660864Z","LastSeen":"2022-11-27T10:36:04.4660864Z","ExtendedInfo":{"DwellTime":3,"FileMD5":"57998FB8E33C4CDFB04F6B78E2A15CA1","FileSize":68,"UserName":"User2","IPAddress":"95.21.77.28","Determination":"B","FileVendor":"","FileProduct":"","FileVersion":""}}]}