GET /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints/{endpointId}/threathistory
?startDate={startDate}
&endDate={endDate}
&returnedInfo={returnedInfo}
&pageSize={pageSize}
&pageNr={pageNr}

Gets threat history information for a given endpoint.

NOTE: The maximum allowed time difference between 'startDate' and 'endDate' is 3 calendar months.

Request Information

URI Parameters

Name	Description	Type	Additional Information
gsmKey	The GSM console keycode.	string	Required
siteId	The site identifier.	string	Required
endpointId	The endpoint identifier.	string	Required
startDate	If specified, returns all threat history records after (or at) the given date. If omitted, defaults to 'endDate' minus 24 hours.	date	None.
endDate	If specified, returns all threat history records before (or at) the given date. If omitted, defaults to the current date and time.	date	None.
returnedInfo	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.	string	None.
pageSize	Specifies the number of records to return.	integer	Default value is 50
pageNr	Specifies the page number. Can be used to retrieve the next batch of records.	integer	Default value is 1

URI Sample(s)


GET	https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/endpoints/1ffe613e-b23c-4eb8-82c7-623502a83e6b/threathistory
GET	https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/endpoints/1ffe613e-b23c-4eb8-82c7-623502a83e6b/threathistory?returnedInfo=ExtendedInfo
GET	https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/endpoints/1ffe613e-b23c-4eb8-82c7-623502a83e6b/threathistory?startDate=2018-09-01&endDate=2018-09-30&pageSize=100&pageNr=3

Body Parameters

None.

Response Information

Resource Description

Information about matching threat history records.

GetThreatHistoryResponseModel

Name	Description	Type	Additional Information
MoreAvailable	Value indicating whether more records are available in the queried time window. Increment the page number in the query to obtain additional threat history records.	boolean	None.
PageNr	The number of the page that was requested.	integer	None.
PageSize	The size of the page that was requested.	integer	None.
StartDate	Start date for returned records. Threat history entries after (or at) this date are contained in the response.	date	None.
EndDate	End date for returned records. Threat history entries before (or at) this date are contained in the response.	date	None.
ThreatRecords	List of threat history records.	Collection of GetThreatHistoryResponseModel_Record	None.

Sample Response

{
  "MoreAvailable": false,
  "PageNr": 1,
  "PageSize": 50,
  "StartDate": "2025-04-04T07:27:44.1647592Z",
  "EndDate": "2025-07-04T07:27:44.1647592Z",
  "ThreatRecords": [
    {
      "EndpointId": "3308fc3b-79e2-47b7-a2d2-b635f4afc770",
      "MachineId": "17D674B133B4452D980020950ABF7731:::D9A3107250CB4863AB39B2D059AC7C83:::D9A3107250CB4863AB39B2D059AC7C83",
      "HostName": "MyComputer1",
      "FileName": "eicar.com",
      "PathName": "?:\\users\\user1\\desktop",
      "MalwareGroup": "Anti-Malware Testfile",
      "FirstSeen": "2025-06-21T07:27:44.1647592Z",
      "LastSeen": "2025-07-02T07:27:44.1647592Z",
      "ExtendedInfo": {
        "DwellTime": 28,
        "FileMD5": "96C99349E5794829BC331FD64DD87A5A",
        "FileSize": 68,
        "UserName": "User1",
        "IPAddress": "95.236.68.74",
        "Determination": "B",
        "FileVendor": "",
        "FileProduct": "",
        "FileVersion": ""
      }
    },
    {
      "EndpointId": "fa3c2788-8c64-4197-9aaf-057766e7305c",
      "MachineId": "0E9FC9B1620C445EB3B5969559AA1457:::752855BD7D434EC48669C52B773AB2F0:::752855BD7D434EC48669C52B773AB2F0",
      "HostName": "MyComputer2",
      "FileName": "eicar.com",
      "PathName": "?:\\users\\user2\\desktop",
      "MalwareGroup": "Anti-Malware Testfile",
      "FirstSeen": "2025-06-21T07:27:44.1647592Z",
      "LastSeen": "2025-07-02T07:27:44.1647592Z",
      "ExtendedInfo": {
        "DwellTime": 378,
        "FileMD5": "DFA1DFCD168A450AADF01335CD542A91",
        "FileSize": 68,
        "UserName": "User2",
        "IPAddress": "95.247.48.244",
        "Determination": "B",
        "FileVendor": "",
        "FileProduct": "",
        "FileVersion": ""
      }
    }
  ]
}

<GetThreatHistoryResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <EndDate>2025-07-04T07:27:44.1647592Z</EndDate>
  <MoreAvailable>false</MoreAvailable>
  <PageNr>1</PageNr>
  <PageSize>50</PageSize>
  <StartDate>2025-04-04T07:27:44.1647592Z</StartDate>
  <ThreatRecords>
    <GetThreatHistoryResponseModel_Record>
      <EndpointId>3308fc3b-79e2-47b7-a2d2-b635f4afc770</EndpointId>
      <ExtendedInfo>
        <Determination>B</Determination>
        <DwellTime>28</DwellTime>
        <FileMD5>96C99349E5794829BC331FD64DD87A5A</FileMD5>
        <FileProduct></FileProduct>
        <FileSize>68</FileSize>
        <FileVendor></FileVendor>
        <FileVersion></FileVersion>
        <IPAddress>95.236.68.74</IPAddress>
        <UserName>User1</UserName>
      </ExtendedInfo>
      <FileName>eicar.com</FileName>
      <FirstSeen>2025-06-21T07:27:44.1647592Z</FirstSeen>
      <HostName>MyComputer1</HostName>
      <LastSeen>2025-07-02T07:27:44.1647592Z</LastSeen>
      <MachineId>17D674B133B4452D980020950ABF7731:::D9A3107250CB4863AB39B2D059AC7C83:::D9A3107250CB4863AB39B2D059AC7C83</MachineId>
      <MalwareGroup>Anti-Malware Testfile</MalwareGroup>
      <PathName>?:\users\user1\desktop</PathName>
    </GetThreatHistoryResponseModel_Record>
    <GetThreatHistoryResponseModel_Record>
      <EndpointId>fa3c2788-8c64-4197-9aaf-057766e7305c</EndpointId>
      <ExtendedInfo>
        <Determination>B</Determination>
        <DwellTime>378</DwellTime>
        <FileMD5>DFA1DFCD168A450AADF01335CD542A91</FileMD5>
        <FileProduct></FileProduct>
        <FileSize>68</FileSize>
        <FileVendor></FileVendor>
        <FileVersion></FileVersion>
        <IPAddress>95.247.48.244</IPAddress>
        <UserName>User2</UserName>
      </ExtendedInfo>
      <FileName>eicar.com</FileName>
      <FirstSeen>2025-06-21T07:27:44.1647592Z</FirstSeen>
      <HostName>MyComputer2</HostName>
      <LastSeen>2025-07-02T07:27:44.1647592Z</LastSeen>
      <MachineId>0E9FC9B1620C445EB3B5969559AA1457:::752855BD7D434EC48669C52B773AB2F0:::752855BD7D434EC48669C52B773AB2F0</MachineId>
      <MalwareGroup>Anti-Malware Testfile</MalwareGroup>
      <PathName>?:\users\user2\desktop</PathName>
    </GetThreatHistoryResponseModel_Record>
  </ThreatRecords>
</GetThreatHistoryResponseModel>

GET /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints/{endpointId}/threathistory ?startDate={startDate} &endDate={endDate} &returnedInfo={returnedInfo} &pageSize={pageSize} &pageNr={pageNr}