Gets threat history information for endpoints on a group.
GET {{baseUrl}}/api/console/gsm/:gsmKey/sites/:siteId/groups/:groupId/threathistory?startDate=2022-10-30T10:36:04.4348315Z&endDate=2022-11-29T10:36:04.4348315Z&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.4348315Z","EndDate":"2022-11-29T10:36:04.4348315Z","ThreatRecords":[{"EndpointId":"a15e8dd7-ec0c-4acd-835e-8714566131ad","MachineId":"8AC2C856DAED46A3A4AFC14419520969:::331AA388B13C446AAB30B55A524589B4:::331AA388B13C446AAB30B55A524589B4","HostName":"MyComputer1","FileName":"eicar.com","PathName":"?:\\users\\user1\\desktop","MalwareGroup":"Anti-Malware Testfile","FirstSeen":"2022-11-16T10:36:04.4348315Z","LastSeen":"2022-11-27T10:36:04.4348315Z","ExtendedInfo":{"DwellTime":644,"FileMD5":"3A7CEC6C6FF9408DB577A3B20E944136","FileSize":68,"UserName":"User1","IPAddress":"95.35.170.84","Determination":"B","FileVendor":"","FileProduct":"","FileVersion":""}},{"EndpointId":"67da4a27-1ce3-4e8f-a7f9-02d1a74a0966","MachineId":"A09145DFB8AC40849227472B73D2A437:::7EBC909AEEE145089399426FDEB26AD1:::7EBC909AEEE145089399426FDEB26AD1","HostName":"MyComputer2","FileName":"eicar.com","PathName":"?:\\users\\user2\\desktop","MalwareGroup":"Anti-Malware Testfile","FirstSeen":"2022-11-16T10:36:04.4348315Z","LastSeen":"2022-11-27T10:36:04.4348315Z","ExtendedInfo":{"DwellTime":239,"FileMD5":"AA26977C49D14DA9BA4158E4D5B9347E","FileSize":68,"UserName":"User2","IPAddress":"95.173.111.24","Determination":"B","FileVendor":"","FileProduct":"","FileVersion":""}}]}