GET /service/api/status/reporting/gsm/{gsmKey}/endpoints
 ?reportType={reportType}
 &effectiveDate={effectiveDate}
 &continuation={continuation}

Returns an endpoint-level summary report of endpoint usage for a GSM master keycode. For each endpoint the report includes information like the endpoint's hostname, machine identifier, and its activation state

Note: This report can become quite large depending on the number of endpoints that are managed for the given GSM console. The maximum number of returned endpoint records is limited to 10,000 to ensure that requests can complete in reasonable time. If more endpoint records are available a continuationToken is returned as part of the ReportInfo data, which can be used to query additional endpoint data.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

A master keycode for which usage information is to be retrieved.

string

Required

reportType

The type of report to be produced. The following values are supported:

  • "ActiveEndpoints": Includes all active devices on the effective report date. Note: If hidden data filter is set within the Webroot console, and if some devices have moved to hidden, the “ActiveEndpoints” will show all hidden as well as non-hidden devices in the total.
  • "ActiveEndpointsWithoutHidden": Includes active devices on the effective report date except for those that were hidden. Note: Reflects the Active Devices total seen within the Webroot console under sites, which filters out any hidden devices. Therefore if hidden devices exist, this device total will be less than “ActiveEndpoints” total.
  • "EndpointsSeenInLast30Days": Includes all devices seen in the last 30 days (between the effective report date and 30 days earlier) except for those that were deactivated before this period.
If omitted, the reportType is set to "EndpointsSeenInLast30Days".

string

None.

effectiveDate

The date the report should refer to. If omitted, the most recent usage report will be returned.

Note: Usage data will typically be generated in the course of the following day (UTC) and therefore can only be provided for dates earlier than yesterday. If, for example, this API method is called at 11:00 pm UTC, yesterday's data will not be available yet.

date

None.

continuation

The continuation token for batched requests.

string

None.

Body Parameters

None.

Response Information

Resource Description

Returns a list of endpoint usage statistics having the specified master key as parent.

UsageReportEndpoints
NameDescriptionTypeAdditional Information
ReportInfo

Details about the returned report.

UsageReportEndpoints_ReportInfo

None.

Endpoints

A list of endpoints.

Collection of UsageReportEndpoints_EndpointEntry

None.

Sample Response

{
  "ReportInfo": {
    "Count": 2,
    "ContinuationToken": "Xb_kq4YLor_9xGAH",
    "SiteKeyFilter": null,
    "ReportType": "EndpointsSeenInLast30Days",
    "EffectiveDate": "2019-05-12T00:00:00Z",
    "GSMKey": "O6YH-HAQV-NU19-5WAI-3T89"
  },
  "Endpoints": [
    {
      "MachineId": "fce6d096a4a58a00a25b993b976f1c6e8dc1c129291161e9025fbbe592d6aa5e:::dbcbde39fc8081578dee672de7893ce8333a43b2:::dbcbde39fc8081578dee672de7893ce8333a43b2",
      "SiteId": "748e9e5e-62c6-7dca-75c7-198218d474ec",
      "SiteKey": "3R3N-43ZP-QOU8-2OOW-MH5A",
      "HostName": "NODEPPHBFBDCPT",
      "FriendlyHostName": "FRIENDLY-NODEPPHBFBDCPT",
      "LastSeen": "2019-04-30T05:02:15.1238818Z",
      "DeviceType": "MAC",
      "IsHidden": true,
      "IsDeactivated": true,
      "IsTrial": false,
      "ActivationStatusTime": "2019-05-07T01:46:15.1238818Z"
    },
    {
      "MachineId": "e1dccc1565b46c03289238ae6ce55cc5d74c3f819ced0b3b36d17aa66e6fec0a:::867f74f2f7869deb932eeae2dd54993dc44a343e:::867f74f2f7869deb932eeae2dd54993dc44a343e",
      "SiteId": "3817a009-5a02-12a4-00cc-13c291071d15",
      "SiteKey": "4UAY-MZWE-Z7RL-DW9Y-UNJY",
      "HostName": "NODEAXRIW9XB24",
      "FriendlyHostName": "FRIENDLY-NODEAXRIW9XB24",
      "LastSeen": "2019-05-05T04:26:15.1238818Z",
      "DeviceType": "MAC",
      "IsHidden": false,
      "IsDeactivated": true,
      "IsTrial": true,
      "ActivationStatusTime": "2019-05-11T08:38:15.1238818Z"
    }
  ]
}                    
<StatusReporting.UsageReportEndpoints xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.AgentStatus.Models">
  <Endpoints>
    <StatusReporting.UsageReportEndpoints_EndpointEntry>
      <ActivationStatusTime>2019-05-07T01:46:15.1238818Z</ActivationStatusTime>
      <DeviceType>MAC</DeviceType>
      <FriendlyHostName>FRIENDLY-NODEPPHBFBDCPT</FriendlyHostName>
      <HostName>NODEPPHBFBDCPT</HostName>
      <IsDeactivated>true</IsDeactivated>
      <IsHidden>true</IsHidden>
      <IsTrial>false</IsTrial>
      <LastSeen>2019-04-30T05:02:15.1238818Z</LastSeen>
      <MachineId>fce6d096a4a58a00a25b993b976f1c6e8dc1c129291161e9025fbbe592d6aa5e:::dbcbde39fc8081578dee672de7893ce8333a43b2:::dbcbde39fc8081578dee672de7893ce8333a43b2</MachineId>
      <SiteId>748e9e5e-62c6-7dca-75c7-198218d474ec</SiteId>
      <SiteKey>3R3N-43ZP-QOU8-2OOW-MH5A</SiteKey>
    </StatusReporting.UsageReportEndpoints_EndpointEntry>
    <StatusReporting.UsageReportEndpoints_EndpointEntry>
      <ActivationStatusTime>2019-05-11T08:38:15.1238818Z</ActivationStatusTime>
      <DeviceType>MAC</DeviceType>
      <FriendlyHostName>FRIENDLY-NODEAXRIW9XB24</FriendlyHostName>
      <HostName>NODEAXRIW9XB24</HostName>
      <IsDeactivated>true</IsDeactivated>
      <IsHidden>false</IsHidden>
      <IsTrial>true</IsTrial>
      <LastSeen>2019-05-05T04:26:15.1238818Z</LastSeen>
      <MachineId>e1dccc1565b46c03289238ae6ce55cc5d74c3f819ced0b3b36d17aa66e6fec0a:::867f74f2f7869deb932eeae2dd54993dc44a343e:::867f74f2f7869deb932eeae2dd54993dc44a343e</MachineId>
      <SiteId>3817a009-5a02-12a4-00cc-13c291071d15</SiteId>
      <SiteKey>4UAY-MZWE-Z7RL-DW9Y-UNJY</SiteKey>
    </StatusReporting.UsageReportEndpoints_EndpointEntry>
  </Endpoints>
  <ReportInfo>
    <EffectiveDate>2019-05-12T00:00:00Z</EffectiveDate>
    <GSMKey>O6YH-HAQV-NU19-5WAI-3T89</GSMKey>
    <ReportType>EndpointsSeenInLast30Days</ReportType>
    <ContinuationToken>Xb_kq4YLor_9xGAH</ContinuationToken>
    <Count>2</Count>
    <SiteKeyFilter i:nil="true" />
  </ReportInfo>
</StatusReporting.UsageReportEndpoints>