Unity API Documentation

GET /service/api/console/gsm/{gsmKey}/sites/{siteId}/groups/{groupId}/endpoints
 ?order={order}
 &orderDirection={orderDirection}
 &pageSize={pageSize}
 &pageNr={pageNr}

Gets the list of endpoints on a given group.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

The GSM console keycode.

 string

Required
siteId

The site identifier.

 string

Required
groupId

The group identifier.

 string

Required
order

Used to determine the order field. Valid values are "hostname", "firstseen", "lastseen", "agentversion", "lastinfected". Default value is "hostname".

 string

None.
orderDirection

Used to sort the data. "A" for ascending. "D" for descending. Default value is "A".

 string

None.
pageSize

Specifies the number of records being returned.

 integer

Default value is 50
pageNr

Specifies the page number. Can be used to retrieve the next batch of records. Default value is 1.

 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/groups/4f08f3ad-7688-4d40-98a6-89bbf7df3daf/endpoints
GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/groups/4f08f3ad-7688-4d40-98a6-89bbf7df3daf/endpoints?pageSize=100&pageNr=3
GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/groups/4f08f3ad-7688-4d40-98a6-89bbf7df3daf/endpoints?order=lastseen&orderDirection=A

Body Parameters

None.

Response Information

Resource Description

Information about the list of endpoints on a given group.

GetEndpointsResponseModel
NameDescriptionTypeAdditional Information
TotalAvailable

Use this value to determine if you need to retrieve additional pages of data. If TotalAvailable is larger than PageNr * PageSize then more endpoints are available.

 integer

None.
PageNr

The number of the page that was request.

 integer

None.
PageSize

The size of the page that was requested.

 integer

None.
Endpoints

List of endpoint records.

 Collection of GetEndpointsResponseModel_Endpoint

None.

Sample Response

{
  "TotalAvailable": 2,
  "PageNr": 1,
  "PageSize": 50,
  "Endpoints": [
    {
      "Seq": 1,
      "EndpointId": "378a73ef-f280-4b3e-8231-aea6da76ea4e",
      "HostName": "MyComputer1",
      "GroupName": "Test Group",
      "FirstSeen": "2019-12-24T21:53:28.0463276Z",
      "LastSeen": "2019-12-24T21:53:28.0463276Z",
      "AgentVersion": "9.0.13.58",
      "LicenseKey": "B1AD-2E59-5345-4B75-BEE9",
      "Expired": false,
      "LastChangesUserId": "1c354471-0f25-41ba-b61d-9044ab41c780",
      "MachineId": "BE7263D0BBC94AE884CF5E5C2081E13B:::3728D9FCE0B949BFBF25FA713B5AFA72:::3728D9FCE0B949BFBF25FA713B5AFA72",
      "PolicyId": "b4958f00-099f-46ac-9658-67ef7fe21c9f",
      "VM": false,
      "AgentLanguage": "en",
      "FriendlyPCName": "",
      "GroupId": "72f6a6e4-6d6a-4d20-b492-5b56fea875c3",
      "PolicyName": "Test Policy",
      "LastInfected": "2020-02-24T21:53:28.0463276Z",
      "InfectedNow": false,
      "NumUsers": 1,
      "MaxUsers": 2,
      "InternalIP": "10.95.183.104",
      "MACAddress": "A4-B2-D0-90-56-66",
      "ADDomain": "domain.webroot.com",
      "ADOU": "Webroot.Computers",
      "Workgroup": "WORKGROUP",
      "CurrentUser": "Paul",
      "Mac": false,
      "WindowsFullOS": "Windows 7 Service Pack 1 (Build 7601) 64bit",
      "LastPublicIP": "95.40.68.116",
      "Deactivated": false,
      "LastScanSeq": "2010951721",
      "ModifiedDate": "2020-05-17T21:53:28.0463276Z"
    },
    {
      "Seq": 2,
      "EndpointId": "7c21ea07-7a6c-4ac9-9bbc-a30dbbb7f271",
      "HostName": "MyComputer2",
      "GroupName": "Test Group",
      "FirstSeen": "2019-07-24T21:53:28.0463276Z",
      "LastSeen": "2019-07-24T21:53:28.0463276Z",
      "AgentVersion": "9.0.13.58",
      "LicenseKey": "B1AD-2E59-5345-4B75-BEE9",
      "Expired": false,
      "LastChangesUserId": "217a2d04-937b-4b8a-8aea-238f0f37105e",
      "MachineId": "25A25B7EAC3944C19A0FB1F004DDE8CC:::CAF25019292B42BE86E5961598D538FF:::CAF25019292B42BE86E5961598D538FF",
      "PolicyId": "72fd54a2-3cc4-4e1e-ab66-62a26700b82f",
      "VM": false,
      "AgentLanguage": "en",
      "FriendlyPCName": "",
      "GroupId": "a5525531-7bea-4069-a8b7-b8fa3aee0dae",
      "PolicyName": "Test Policy",
      "LastInfected": "2019-11-24T21:53:28.0463276Z",
      "InfectedNow": false,
      "NumUsers": 1,
      "MaxUsers": 4,
      "InternalIP": "10.220.104.148",
      "MACAddress": "9F-B5-A9-F0-B9-4E",
      "ADDomain": "domain.webroot.com",
      "ADOU": "Webroot.Computers",
      "Workgroup": "WORKGROUP",
      "CurrentUser": "Paul",
      "Mac": false,
      "WindowsFullOS": "Windows 7 Service Pack 1 (Build 7601) 64bit",
      "LastPublicIP": "95.166.30.6",
      "Deactivated": false,
      "LastScanSeq": "1052486930",
      "ModifiedDate": "2020-05-10T21:53:28.0463276Z"
    }
  ]
}                    
<GetEndpointsResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <Endpoints>
    <GetEndpointsResponseModel_Endpoint>
      <ADDomain>domain.webroot.com</ADDomain>
      <ADOU>Webroot.Computers</ADOU>
      <AgentLanguage>en</AgentLanguage>
      <AgentVersion>9.0.13.58</AgentVersion>
      <CurrentUser>Paul</CurrentUser>
      <Deactivated>false</Deactivated>
      <EndpointId>378a73ef-f280-4b3e-8231-aea6da76ea4e</EndpointId>
      <Expired>false</Expired>
      <FirstSeen>2019-12-24T21:53:28.0463276Z</FirstSeen>
      <FriendlyPCName></FriendlyPCName>
      <GroupId>72f6a6e4-6d6a-4d20-b492-5b56fea875c3</GroupId>
      <GroupName>Test Group</GroupName>
      <HostName>MyComputer1</HostName>
      <InfectedNow>false</InfectedNow>
      <InternalIP>10.95.183.104</InternalIP>
      <LastChangesUserId>1c354471-0f25-41ba-b61d-9044ab41c780</LastChangesUserId>
      <LastInfected>2020-02-24T21:53:28.0463276Z</LastInfected>
      <LastPublicIP>95.40.68.116</LastPublicIP>
      <LastScanSeq>2010951721</LastScanSeq>
      <LastSeen>2019-12-24T21:53:28.0463276Z</LastSeen>
      <LicenseKey>B1AD-2E59-5345-4B75-BEE9</LicenseKey>
      <MACAddress>A4-B2-D0-90-56-66</MACAddress>
      <Mac>false</Mac>
      <MachineId>BE7263D0BBC94AE884CF5E5C2081E13B:::3728D9FCE0B949BFBF25FA713B5AFA72:::3728D9FCE0B949BFBF25FA713B5AFA72</MachineId>
      <MaxUsers>2</MaxUsers>
      <ModifiedDate>2020-05-17T21:53:28.0463276Z</ModifiedDate>
      <NumUsers>1</NumUsers>
      <PolicyId>b4958f00-099f-46ac-9658-67ef7fe21c9f</PolicyId>
      <PolicyName>Test Policy</PolicyName>
      <Seq>1</Seq>
      <VM>false</VM>
      <WindowsFullOS>Windows 7 Service Pack 1 (Build 7601) 64bit</WindowsFullOS>
      <Workgroup>WORKGROUP</Workgroup>
    </GetEndpointsResponseModel_Endpoint>
    <GetEndpointsResponseModel_Endpoint>
      <ADDomain>domain.webroot.com</ADDomain>
      <ADOU>Webroot.Computers</ADOU>
      <AgentLanguage>en</AgentLanguage>
      <AgentVersion>9.0.13.58</AgentVersion>
      <CurrentUser>Paul</CurrentUser>
      <Deactivated>false</Deactivated>
      <EndpointId>7c21ea07-7a6c-4ac9-9bbc-a30dbbb7f271</EndpointId>
      <Expired>false</Expired>
      <FirstSeen>2019-07-24T21:53:28.0463276Z</FirstSeen>
      <FriendlyPCName></FriendlyPCName>
      <GroupId>a5525531-7bea-4069-a8b7-b8fa3aee0dae</GroupId>
      <GroupName>Test Group</GroupName>
      <HostName>MyComputer2</HostName>
      <InfectedNow>false</InfectedNow>
      <InternalIP>10.220.104.148</InternalIP>
      <LastChangesUserId>217a2d04-937b-4b8a-8aea-238f0f37105e</LastChangesUserId>
      <LastInfected>2019-11-24T21:53:28.0463276Z</LastInfected>
      <LastPublicIP>95.166.30.6</LastPublicIP>
      <LastScanSeq>1052486930</LastScanSeq>
      <LastSeen>2019-07-24T21:53:28.0463276Z</LastSeen>
      <LicenseKey>B1AD-2E59-5345-4B75-BEE9</LicenseKey>
      <MACAddress>9F-B5-A9-F0-B9-4E</MACAddress>
      <Mac>false</Mac>
      <MachineId>25A25B7EAC3944C19A0FB1F004DDE8CC:::CAF25019292B42BE86E5961598D538FF:::CAF25019292B42BE86E5961598D538FF</MachineId>
      <MaxUsers>4</MaxUsers>
      <ModifiedDate>2020-05-10T21:53:28.0463276Z</ModifiedDate>
      <NumUsers>1</NumUsers>
      <PolicyId>72fd54a2-3cc4-4e1e-ab66-62a26700b82f</PolicyId>
      <PolicyName>Test Policy</PolicyName>
      <Seq>2</Seq>
      <VM>false</VM>
      <WindowsFullOS>Windows 7 Service Pack 1 (Build 7601) 64bit</WindowsFullOS>
      <Workgroup>WORKGROUP</Workgroup>
    </GetEndpointsResponseModel_Endpoint>
  </Endpoints>
  <PageNr>1</PageNr>
  <PageSize>50</PageSize>
  <TotalAvailable>2</TotalAvailable>
</GetEndpointsResponseModel>