Documentation

GET /service/api/status/reporting/gsm/{gsmKey}/sites/{keyCode}
?reportType={reportType}
&effectiveDate={effectiveDate}

Returns a site-level summary report of endpoint usage for a GSM master keycode by a site keycode. The report includes information like the site name and license type as well as the total number of endpoints.

Request Information

URI Parameters

Name	Description	Type	Additional Information
gsmKey	A master keycode for which usage information is to be retrieved.	string	Required
keyCode	The keycode of the site 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). 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.

URI Sample(s)

GET	https://unityapi.webrootcloudav.com/service/api/status/reporting/gsm/C8FB-6ACE-6EA8-402F-B320/sites/6479-966B-F747-4B51-99CB?reportType=ActiveEndpointsWithoutHidden&effectiveDate=2024-10-03T00:00:00.0000000Z

Body Parameters

None.

Response Information

Resource Description

Returns site keycode usage statistics for the specified site keycode.

UsageReportSite

Name	Description	Type	Additional Information
ReportInfo	Details about the returned report.	UsageReportSites_ReportInfo	None.
Sites	Site/endpoint details for a given GSM site.	Collection of UsageReportSites_SiteEntry	None.

Sample Response

{
  "ReportInfo": {
    "Count": 1,
    "SiteKeyFilter": null,
    "ReportType": "ActiveEndpoints",
    "EffectiveDate": "2024-10-02T00:00:00Z",
    "GSMKey": "a1vrnjaw818w46romw4x"
  },
  "Sites": [
    {
      "SiteId": "5bf97703-3889-60db-3c1d-6beb4fa066ee",
      "SiteKey": "k5wchaiwbfq9cvirpwbu",
      "SiteName": "Site KWBET4PU5B",
      "LicenseType": "Full",
      "ExpiryDate": "2026-05-06T09:12:29.8840816Z",
      "SiteState": "active",
      "SiteStateChangedDate": "2024-09-16T04:43:29.8840816Z",
      "TotalEndpoints": 7927
    }
  ]
}

<StatusReporting.UsageReportSite xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.AgentStatus.Models">
  <ReportInfo>
    <EffectiveDate>2024-10-02T00:00:00Z</EffectiveDate>
    <GSMKey>a1vrnjaw818w46romw4x</GSMKey>
    <ReportType>ActiveEndpoints</ReportType>
    <Count>1</Count>
    <SiteKeyFilter i:nil="true" />
  </ReportInfo>
  <Sites>
    <StatusReporting.UsageReportSites_SiteEntry>
      <ExpiryDate>2026-05-06T09:12:29.8840816Z</ExpiryDate>
      <LicenseType>Full</LicenseType>
      <SiteId>5bf97703-3889-60db-3c1d-6beb4fa066ee</SiteId>
      <SiteKey>k5wchaiwbfq9cvirpwbu</SiteKey>
      <SiteName>Site KWBET4PU5B</SiteName>
      <SiteState>active</SiteState>
      <SiteStateChangedDate>2024-09-16T04:43:29.8840816Z</SiteStateChangedDate>
      <TotalEndpoints>7927</TotalEndpoints>
    </StatusReporting.UsageReportSites_SiteEntry>
  </Sites>
</StatusReporting.UsageReportSite>

GET /service/api/status/reporting/gsm/{gsmKey}/sites/{keyCode} ?reportType={reportType} &effectiveDate={effectiveDate}