Unity API Documentation

GET /service/api/console/gsm/{gsmKey}/lookupsite/{siteKeycode}

Looks up information about a specific GSM site which is associated with a given site keycode. You can use this method to query site details using a site keycode and to retrieve the site's identifier for follow-up calls.

Request Information

URI Parameters

NameDescriptionTypeAdditional Information
gsmKey

The GSM console keycode.

 string

Required
siteKeycode

The site keycode to look up.

 string

Required

URI Sample(s)

GET
https://unityapi.webrootcloudav.com/service/api/console/gsm/C3FF-B48D-3E33-4544-B23C/lookupsite/B47D-A294-7A73-4A69-9908

Body Parameters

None.

Response Information

Resource Description

Information about the desired GSM site.

GetGSMSitesResponseModel
NameDescriptionTypeAdditional Information
TotalSeatsAllowed

The total number of Parent Keycode Site Seats/devices purchased.

 integer

None.
ParentDescription

Indicates if parent key is a "Full" or "Trial" license.

 string

None.
SumTotalDevices

The total number of Active Devices installed on the GSM sites.

 integer

None.
SumTotalDevicesAllowed

The total number of Site Seats allocated to all GSM sites.

 integer

None.
SumTotalDevicesNotTrial

The total number of Site Seats allocated to all GSM sites which are not trial sites.

 integer

None.
SumTotalMobileDevicesAllowed

The total number of mobile Site Seats allocated to the GSM sites.

 integer

None.
TotalCount

The total number of sites under the GSM.

 integer

None.
Sites

List of site details records.

 Collection of GetGSMSitesResponseModel_Site

None.

Sample Response

{
  "TotalSeatsAllowed": 250,
  "ParentDescription": "Full",
  "SumTotalDevices": 57,
  "SumTotalDevicesAllowed": 200,
  "SumTotalDevicesNotTrial": 200,
  "SumTotalMobileDevicesAllowed": 50,
  "TotalCount": 1,
  "Sites": [
    {
      "SiteId": "f82f7751-e30f-45ab-b6c1-850f257d0c25",
      "SiteName": "Site 1",
      "SiteType": "R",
      "TotalEndpoints": 24,
      "PCsInfected24": 0,
      "AccountKeyCode": "C791-3CB0-CF0D-468E-AAB9",
      "DevicesAllowed": 100,
      "MobileSeats": 5,
      "Deactivated": false,
      "Suspended": false,
      "EndDate": "2024-10-24T06:17:57.2263855Z",
      "Device": true,
      "Infect": false,
      "BillingCycle": "Anually",
      "BillingDate": "Jan 01",
      "CompanyComments": "",
      "DeactivatedBy": null,
      "SuspendedBy": null,
      "CreatedBy": "test@webroot.com",
      "GlobalPolicies": true,
      "GlobalOverrides": true,
      "GlobalAlerts": true,
      "AllKeysExpired": false,
      "Description": "Full",
      "PolicyId": "c0cd5b19-1f96-4e08-b071-cbb624df2178",
      "PolicyName": "Test policy",
      "PolicyDescription": "Sample policy for testing",
      "Emails": "test@webroot.com",
      "AccessLevel": 128,
      "Modules": [
        {
          "Type": "DNSP",
          "LicenseType": "Trial",
          "EndDate": "2024-10-24T06:17:57.2263855Z"
        },
        {
          "Type": "WSAT",
          "LicenseType": "Trial",
          "EndDate": "2024-10-24T06:17:57.2263855Z"
        }
      ]
    }
  ]
}                    
<GetGSMSitesResponseModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.Console.Models">
  <ParentDescription>Full</ParentDescription>
  <Sites>
    <GetGSMSitesResponseModel_Site>
      <AccessLevel>128</AccessLevel>
      <AccountKeyCode>C791-3CB0-CF0D-468E-AAB9</AccountKeyCode>
      <AllKeysExpired>false</AllKeysExpired>
      <BillingCycle>Anually</BillingCycle>
      <BillingDate>Jan 01</BillingDate>
      <CompanyComments></CompanyComments>
      <CreatedBy>test@webroot.com</CreatedBy>
      <Deactivated>false</Deactivated>
      <DeactivatedBy i:nil="true" />
      <Description>Full</Description>
      <Device>true</Device>
      <DevicesAllowed>100</DevicesAllowed>
      <Emails>test@webroot.com</Emails>
      <EndDate>2024-10-24T06:17:57.2263855Z</EndDate>
      <GlobalAlerts>true</GlobalAlerts>
      <GlobalOverrides>true</GlobalOverrides>
      <GlobalPolicies>true</GlobalPolicies>
      <Infect>false</Infect>
      <MobileSeats>5</MobileSeats>
      <Modules>
        <GetGSMSitesResponseModel_Module>
          <EndDate>2024-10-24T06:17:57.2263855Z</EndDate>
          <LicenseType>Trial</LicenseType>
          <Type>DNSP</Type>
        </GetGSMSitesResponseModel_Module>
        <GetGSMSitesResponseModel_Module>
          <EndDate>2024-10-24T06:17:57.2263855Z</EndDate>
          <LicenseType>Trial</LicenseType>
          <Type>WSAT</Type>
        </GetGSMSitesResponseModel_Module>
      </Modules>
      <PCsInfected24>0</PCsInfected24>
      <PolicyDescription>Sample policy for testing</PolicyDescription>
      <PolicyId>c0cd5b19-1f96-4e08-b071-cbb624df2178</PolicyId>
      <PolicyName>Test policy</PolicyName>
      <SiteId>f82f7751-e30f-45ab-b6c1-850f257d0c25</SiteId>
      <SiteName>Site 1</SiteName>
      <SiteType>R</SiteType>
      <Suspended>false</Suspended>
      <SuspendedBy i:nil="true" />
      <TotalEndpoints>24</TotalEndpoints>
    </GetGSMSitesResponseModel_Site>
  </Sites>
  <SumTotalDevices>57</SumTotalDevices>
  <SumTotalDevicesAllowed>200</SumTotalDevicesAllowed>
  <SumTotalDevicesNotTrial>200</SumTotalDevicesNotTrial>
  <SumTotalMobileDevicesAllowed>50</SumTotalMobileDevicesAllowed>
  <TotalCount>1</TotalCount>
  <TotalSeatsAllowed>250</TotalSeatsAllowed>
</GetGSMSitesResponseModel>