Unity API Documentation

GET /service/api/console/gsm/{gsmKey}/sites/{siteId}/endpoints
 ?type={type}
 &hostName={hostName}
 &machineId={machineId}
 &order={order}
 &orderDirection={orderDirection}
 &pageSize={pageSize}
 &pageNr={pageNr}

Gets the list of endpoints on a given GSM site.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

The GSM console keycode.

 string

Required
siteId

The site identifier.

 string

Required
type

Can be set to "active" (returns active endpoints only) or "deactivated" (returns deactivated endpoints only). If this parameter is omitted, endpoints regardless of their activation state are returned.

 string

None.
hostName

Used to search for a particular hostname.

 string

None.
machineId

Used to search for a particular machine.

 string

None.
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. If orderDirection is omitted or invalid, the data will be sorted in ascending order.

 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/endpoints
GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/endpoints?type=active
GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/endpoints?hostName=MyComputer1
GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/endpoints?machineId=e12cee848565435b8533ec7540366f13:::9a3ff75d83634d1386af15c238b575fb:::9a3ff75d83634d1386af15c238b575fb
GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/3515-3EC8-3018-4DAB-A776/sites/3c5b599c-f244-4c7e-a78b-b3e9f252fac8/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/endpoints?order=lastseen&orderDirection=A

Body Parameters

None.

Response Information

Resource Description

Information about the list of endpoints on a given GSM site.

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": "0806cd25-9c95-4a9c-b0c1-8f5f1ea39331",
      "HostName": "MyComputer1",
      "GroupName": "Test Group",
      "FirstSeen": "2023-11-16T12:49:36.9067106Z",
      "LastSeen": "2023-11-16T12:49:36.9067106Z",
      "AgentVersion": "9.0.13.58",
      "LicenseKey": "4F5F-D996-A304-499C-8C43",
      "Expired": false,
      "LastChangesUserId": "9b32afbb-72c5-4764-983e-996f27898d0b",
      "MachineId": "40C63A68289D4AC7A1FD0E64D0F56829:::F98D6E02AC724403A6BD606C60D533D5:::F98D6E02AC724403A6BD606C60D533D5",
      "PolicyId": "a26aa2aa-b380-4827-9395-ce6648a1c280",
      "VM": false,
      "AgentLanguage": "en",
      "FriendlyPCName": "",
      "GroupId": "da2850e3-fe17-4697-876e-919f718fcfca",
      "PolicyName": "Test Policy",
      "LastInfected": "2024-01-16T12:49:36.9067106Z",
      "InfectedNow": false,
      "NumUsers": 1,
      "MaxUsers": 2,
      "InternalIP": "10.80.113.216",
      "MACAddress": "39-E4-01-1E-A5-E0",
      "ADDomain": "domain.webroot.com",
      "ADOU": "Webroot.Computers",
      "Workgroup": "WORKGROUP",
      "CurrentUser": "Paul",
      "Mac": false,
      "WindowsFullOS": "Windows 7 Service Pack 1 (Build 7601) 64bit",
      "LastPublicIP": "95.64.160.87",
      "Deactivated": false,
      "LastScanSeq": "1446046867",
      "ModifiedDate": "2024-04-09T12:49:36.9067106Z"
    },
    {
      "Seq": 2,
      "EndpointId": "fba6bcf5-7374-4ef2-a4b3-61f4c8a82931",
      "HostName": "MyComputer2",
      "GroupName": "Test Group",
      "FirstSeen": "2023-06-16T12:49:36.9067106Z",
      "LastSeen": "2023-06-16T12:49:36.9067106Z",
      "AgentVersion": "9.0.13.58",
      "LicenseKey": "4F5F-D996-A304-499C-8C43",
      "Expired": false,
      "LastChangesUserId": "c0bac6ef-e25f-4c9a-a7d3-05e4132f60d8",
      "MachineId": "0CEB7EC9D63645EAB11B67584FAB2E45:::2F24B644D9F547A5B68A9B69C38725F0:::2F24B644D9F547A5B68A9B69C38725F0",
      "PolicyId": "b7b4aeaa-cd7d-4695-97e9-38c5a1a38b60",
      "VM": false,
      "AgentLanguage": "en",
      "FriendlyPCName": "",
      "GroupId": "b36b31b0-9696-41ea-9641-8d6375d68fa0",
      "PolicyName": "Test Policy",
      "LastInfected": "2023-10-16T12:49:36.9067106Z",
      "InfectedNow": false,
      "NumUsers": 1,
      "MaxUsers": 4,
      "InternalIP": "10.80.180.21",
      "MACAddress": "37-2C-09-42-36-57",
      "ADDomain": "domain.webroot.com",
      "ADOU": "Webroot.Computers",
      "Workgroup": "WORKGROUP",
      "CurrentUser": "Paul",
      "Mac": false,
      "WindowsFullOS": "Windows 7 Service Pack 1 (Build 7601) 64bit",
      "LastPublicIP": "95.75.156.30",
      "Deactivated": false,
      "LastScanSeq": "1465250240",
      "ModifiedDate": "2024-04-02T12:49:36.9067106Z"
    }
  ]
}                    
<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>0806cd25-9c95-4a9c-b0c1-8f5f1ea39331</EndpointId>
      <Expired>false</Expired>
      <FirstSeen>2023-11-16T12:49:36.9067106Z</FirstSeen>
      <FriendlyPCName></FriendlyPCName>
      <GroupId>da2850e3-fe17-4697-876e-919f718fcfca</GroupId>
      <GroupName>Test Group</GroupName>
      <HostName>MyComputer1</HostName>
      <InfectedNow>false</InfectedNow>
      <InternalIP>10.80.113.216</InternalIP>
      <LastChangesUserId>9b32afbb-72c5-4764-983e-996f27898d0b</LastChangesUserId>
      <LastInfected>2024-01-16T12:49:36.9067106Z</LastInfected>
      <LastPublicIP>95.64.160.87</LastPublicIP>
      <LastScanSeq>1446046867</LastScanSeq>
      <LastSeen>2023-11-16T12:49:36.9067106Z</LastSeen>
      <LicenseKey>4F5F-D996-A304-499C-8C43</LicenseKey>
      <MACAddress>39-E4-01-1E-A5-E0</MACAddress>
      <Mac>false</Mac>
      <MachineId>40C63A68289D4AC7A1FD0E64D0F56829:::F98D6E02AC724403A6BD606C60D533D5:::F98D6E02AC724403A6BD606C60D533D5</MachineId>
      <MaxUsers>2</MaxUsers>
      <ModifiedDate>2024-04-09T12:49:36.9067106Z</ModifiedDate>
      <NumUsers>1</NumUsers>
      <PolicyId>a26aa2aa-b380-4827-9395-ce6648a1c280</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>fba6bcf5-7374-4ef2-a4b3-61f4c8a82931</EndpointId>
      <Expired>false</Expired>
      <FirstSeen>2023-06-16T12:49:36.9067106Z</FirstSeen>
      <FriendlyPCName></FriendlyPCName>
      <GroupId>b36b31b0-9696-41ea-9641-8d6375d68fa0</GroupId>
      <GroupName>Test Group</GroupName>
      <HostName>MyComputer2</HostName>
      <InfectedNow>false</InfectedNow>
      <InternalIP>10.80.180.21</InternalIP>
      <LastChangesUserId>c0bac6ef-e25f-4c9a-a7d3-05e4132f60d8</LastChangesUserId>
      <LastInfected>2023-10-16T12:49:36.9067106Z</LastInfected>
      <LastPublicIP>95.75.156.30</LastPublicIP>
      <LastScanSeq>1465250240</LastScanSeq>
      <LastSeen>2023-06-16T12:49:36.9067106Z</LastSeen>
      <LicenseKey>4F5F-D996-A304-499C-8C43</LicenseKey>
      <MACAddress>37-2C-09-42-36-57</MACAddress>
      <Mac>false</Mac>
      <MachineId>0CEB7EC9D63645EAB11B67584FAB2E45:::2F24B644D9F547A5B68A9B69C38725F0:::2F24B644D9F547A5B68A9B69C38725F0</MachineId>
      <MaxUsers>4</MaxUsers>
      <ModifiedDate>2024-04-02T12:49:36.9067106Z</ModifiedDate>
      <NumUsers>1</NumUsers>
      <PolicyId>b7b4aeaa-cd7d-4695-97e9-38c5a1a38b60</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>