Gets threat history information for endpoints on a GSM site.
GET {{baseUrl}}/api/console/gsm/:gsmKey/sites/:siteId/threathistory?startDate=2022-10-30T10:36:04.4035799Z&endDate=2022-11-29T10:36:04.4035799Z&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.4035799Z","EndDate":"2022-11-29T10:36:04.4035799Z","ThreatRecords":[{"EndpointId":"0573c248-35c9-4461-8741-3724b5435986","MachineId":"DF73C7DBC68448838B99436146EABDE4:::DD4910D51DDF442999184236F4EEC737:::DD4910D51DDF442999184236F4EEC737","HostName":"MyComputer1","FileName":"eicar.com","PathName":"?:\\users\\user1\\desktop","MalwareGroup":"Anti-Malware Testfile","FirstSeen":"2022-11-16T10:36:04.4035799Z","LastSeen":"2022-11-27T10:36:04.4035799Z","ExtendedInfo":{"DwellTime":406,"FileMD5":"39C4397F46E04223A6FF20D83E32F6B6","FileSize":68,"UserName":"User1","IPAddress":"95.143.22.190","Determination":"B","FileVendor":"","FileProduct":"","FileVersion":""}},{"EndpointId":"09d602f2-e44f-4f3e-a462-d761686a34e3","MachineId":"841B74A1E3964D989C99B59F31A40854:::A247630ECC4346B6BEB126C2419B4929:::A247630ECC4346B6BEB126C2419B4929","HostName":"MyComputer2","FileName":"eicar.com","PathName":"?:\\users\\user2\\desktop","MalwareGroup":"Anti-Malware Testfile","FirstSeen":"2022-11-16T10:36:04.4035799Z","LastSeen":"2022-11-27T10:36:04.4035799Z","ExtendedInfo":{"DwellTime":535,"FileMD5":"B9FDD9CDA48E4D96A4F3F57405985194","FileSize":68,"UserName":"User2","IPAddress":"95.212.161.159","Determination":"B","FileVendor":"","FileProduct":"","FileVersion":""}}]}