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

Returns a site-level summary report of WSAT usage for a GSM master keycode. For each site the report includes information like the site name and license type as well as the total number of users.

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:

  • "UsersSeen": Provides WSAT statistics for all users seen on the effective report date.
  • "UsersSeenInLast30Days": Provides WSAT statistics for all users seen in the last 30 days (between the effective report date and 30 days earlier).
If omitted, the reportType is set to "UsersSeenInLast30Days".

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.

Body Parameters

None.

Response Information

Resource Description

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

UsageReportSites_WSAT
NameDescriptionTypeAdditional Information
ReportInfo

Details about the returned report.

UsageReportSites_ReportInfo

None.

Sites

Site/endpoint details for a given GSM site.

Collection of UsageReportSites_WSAT_SiteEntry

None.

Sample Response

{
  "ReportInfo": {
    "Count": 2,
    "SiteKeyFilter": null,
    "ReportType": "UsersSeenInLast30Days",
    "EffectiveDate": "2019-09-04T00:00:00Z",
    "GSMKey": "78SM-7F6V-4E9C-KA4A-Z4KU"
  },
  "Sites": [
    {
      "SiteId": "5acb3e88-4ee2-096b-007b-73af535d51f9",
      "SiteKey": "5HKY-UIHO-4CLP-T3QX-VDWA",
      "SiteName": "Site 04IZ71P320",
      "SiteLicenseType": "Full",
      "SiteExpiryDate": "2021-01-13T08:07:41.5302691Z",
      "SiteState": "active",
      "SiteStateChangedDate": "2019-08-23T04:46:41.5302691Z",
      "WSATEnabled": true,
      "WSATLicenseType": "Trial",
      "WSATExpiryDate": "2019-09-26T03:41:41.5302691Z",
      "TotalWSATUsers": 98
    },
    {
      "SiteId": "5a244ec1-6414-522e-4cf8-6cd38a4762dd",
      "SiteKey": "9FHY-YBA8-N56A-9U12-2OVE",
      "SiteName": "Site HGPV4U8IO4",
      "SiteLicenseType": "Full",
      "SiteExpiryDate": "2021-09-01T13:37:41.5302691Z",
      "SiteState": "active",
      "SiteStateChangedDate": "2019-09-02T04:46:41.5302691Z",
      "WSATEnabled": true,
      "WSATLicenseType": "Trial",
      "WSATExpiryDate": "2019-09-21T16:10:41.5302691Z",
      "TotalWSATUsers": 72
    }
  ]
}                    
<StatusReporting.UsageReportSites_WSAT xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.AgentStatus.Models">
  <ReportInfo>
    <EffectiveDate>2019-09-04T00:00:00Z</EffectiveDate>
    <GSMKey>78SM-7F6V-4E9C-KA4A-Z4KU</GSMKey>
    <ReportType>UsersSeenInLast30Days</ReportType>
    <Count>2</Count>
    <SiteKeyFilter i:nil="true" />
  </ReportInfo>
  <Sites>
    <StatusReporting.UsageReportSites_WSAT_SiteEntry>
      <SiteExpiryDate>2021-01-13T08:07:41.5302691Z</SiteExpiryDate>
      <SiteId>5acb3e88-4ee2-096b-007b-73af535d51f9</SiteId>
      <SiteKey>5HKY-UIHO-4CLP-T3QX-VDWA</SiteKey>
      <SiteLicenseType>Full</SiteLicenseType>
      <SiteName>Site 04IZ71P320</SiteName>
      <SiteState>active</SiteState>
      <SiteStateChangedDate>2019-08-23T04:46:41.5302691Z</SiteStateChangedDate>
      <TotalWSATUsers>98</TotalWSATUsers>
      <WSATEnabled>true</WSATEnabled>
      <WSATExpiryDate>2019-09-26T03:41:41.5302691Z</WSATExpiryDate>
      <WSATLicenseType>Trial</WSATLicenseType>
    </StatusReporting.UsageReportSites_WSAT_SiteEntry>
    <StatusReporting.UsageReportSites_WSAT_SiteEntry>
      <SiteExpiryDate>2021-09-01T13:37:41.5302691Z</SiteExpiryDate>
      <SiteId>5a244ec1-6414-522e-4cf8-6cd38a4762dd</SiteId>
      <SiteKey>9FHY-YBA8-N56A-9U12-2OVE</SiteKey>
      <SiteLicenseType>Full</SiteLicenseType>
      <SiteName>Site HGPV4U8IO4</SiteName>
      <SiteState>active</SiteState>
      <SiteStateChangedDate>2019-09-02T04:46:41.5302691Z</SiteStateChangedDate>
      <TotalWSATUsers>72</TotalWSATUsers>
      <WSATEnabled>true</WSATEnabled>
      <WSATExpiryDate>2019-09-21T16:10:41.5302691Z</WSATExpiryDate>
      <WSATLicenseType>Trial</WSATLicenseType>
    </StatusReporting.UsageReportSites_WSAT_SiteEntry>
  </Sites>
</StatusReporting.UsageReportSites_WSAT>