GET /service/api/status/gsm/{keyCode}
?machineId={machineId}
&returnedInfo={returnedInfo}
&modifiedSince={modifiedSince}
&batchSize={batchSize}
&continuation={continuation}
Returns agent status information for all endpoints matching the specified criteria.
Returned information is grouped into several classes which can be selectively included in responses in order to reduce network traffic. Returned items can be grouped into batches by using the 'batchSize' parameter, in which case responses contain a 'continuationURI' and 'ContinuationToken' field, which can be used for requesting the next batch of items.
Request Information
URI Parameters
Name | Description | Type | Additional Information |
---|---|---|---|
keyCode |
A GSM keycode for which agent status information is to be retrieved. |
string |
Required |
machineId |
A machine ID for which agent status is to be retrieved. If omitted, information for all endpoints is retrieved. |
string |
None. |
returnedInfo |
A comma separated list of classes of information to be contained in the response data (BasicInfo,ExtendedInfo,TimesAndStats,Scheduling,EnabledFeatures,SystemAnalyzer,OSAndVersions). If omitted, all classes of information are returned |
string |
None. |
modifiedSince |
If specified, returns all agent status entries, that were modified after (or at) the given date. |
date |
None. |
batchSize |
Specifies the number of entries returned per request. Valid values range from 1 to 1000. |
integer |
Default value is 50 |
continuation |
A continuation token for batched requests |
string |
None. |
URI Sample(s)
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/3515-3EC8-3018-4DAB-A776?batchSize=200
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/3515-3EC8-3018-4DAB-A776?batchSize=200&continuation=H4sIAAAAAAAEAM1SS07DMBQckiBVXXXDATgB8bd2d5RuAmkLilhHsetISGkrlMBVuBBnQGLJgnvgkLRdgYQEEgtrPO_Nm-dn-z4EonWeNG5NcAZgFCN5eT4fEVy2QHHVAkPaAsd1CwI3HhB2dRTHvm7nwnDqSRDjxAPTTDauboxZ2RV1jq_IGLs6jtfAk6sLvHnpcIrBdLlMgUFSt5vMNd50mvXuaYc-2WXC
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/3515-3EC8-3018-4DAB-A776?machineId=8a8a1a12345c1ca9eelw78965a9c8d789c6fc75381d1234567890fffa91c138:::57cf6d537c9a3e12345bbdaa8ba2a98765c1c5c2:::57cf6d123c9a3e12345bbdaa8ba2a98765c1c5c2&returnedInfo=BasicInfo
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/3515-3EC8-3018-4DAB-A776?modifiedSince=2019-01-01T22:30:00.000Z
|
Body Parameters
None.
Response Information
Resource Description
Returns a list of endpoints matching the given criteria. If more items would be returned, than specified by 'batchSize', a continuation URI is returned, which can be used to retrieve the next batch of items
AgentStatusName | Description | Type | Additional Information |
---|---|---|---|
ContinuationToken |
Provides a continuation token for follow-up calls if more data is available than the given batch size. |
string |
None. |
ContinuationURI |
Provides a URI for follow-up calls if more data is available than the given batch size. |
string |
None. |
Count |
Contains the number of endpoints returned in the current request. |
integer |
None. |
QueryResults |
Endpoint information matching the given query parameters. |
Collection of EndpointInfo |
None. |
Sample Response
{ "QueryResults": [ { "BasicInfo": { "StatusRefreshTime": "2025-05-14T14:21:24.8218146Z", "Managed": false, "SKU": "Webroot SecureAnywhere Endpoint Protection", "PartnerNumber": 0, "Version": "9.0.13.58", "ActiveThreats": 0, "DeviceType": "PC", "AttentionRequired": false, "Infected": false }, "ExtendedInfo": { "Uninstalled": false, "Language": "en", "IsExpired": false, "DaysRemaining": 122, "ExpirationDate": "2025-09-13T14:31:24.8218146Z", "RemediationEnabled": true, "ThreatBlocked": false, "WasJustInfected": true, "HasBeenInfected": true, "LatestThreat": "c:\\users\\administrator\\downloads\\eicar_com\\eicar - copy.com|Eicar-Test-Virus|56A0F8A9", "CurrentlyCleaning": false, "CleanShutdown": true, "ManualAgentShutdown": false, "AgentStartupTime": "2025-05-14T09:31:24.8218146Z", "SystemState": 1, "SystemStateUpdated": "2025-05-14T09:31:24.8218146Z" }, "TimesAndStats": { "LastGarbageRemovalTime": null, "LastGarbageRemovalSize": 0, "TotalGarbageRemovalSize": 0, "LastScan": "2025-05-14T12:31:24.8218146Z", "LastScanDuration": 223, "LastScanCount": 126773, "ScanCount": 5, "ThreatsRemoved": 1, "LastQuickScan": null, "LastQuickScanDuration": 0, "LastFullScan": "2025-05-14T12:31:24.8218146Z", "LastFullScanDuration": 738, "LastCustomScan": null, "LastCustomScanDuration": 0, "LastDeepScan": null, "LastDeepScanDuration": 0 }, "Scheduling": { "ScheduledScansEnabled": true, "ScheduledScanFrequency": 0, "ScheduledScanTime": "10:00", "ScanWhenIdle": false, "ScanOnBootup": false, "ActiveScans": 0 }, "EnabledFeatures": { "ProtectionEnabled": true, "RootkitShieldEnabled": true, "WebThreatShieldEnabled": true, "USBShieldEnabled": true, "OfflineShieldEnabled": true, "ScriptShieldStatus": null, "FirewallEnabled": true, "InfraredEnabled": true, "IDShieldEnabled": true, "PhishingShieldEnabled": true, "IsSilent": false }, "SystemAnalyzer": { "SystemAnalyzerScore": 0, "HardwareScore": "", "SoftwareScore": "", "ThreatsScore": "" }, "OSAndVersions": { "OSBuild": 9600, "OSPlatform": 64, "OSLanguage": 1033, "CurrentUser": "Administrator", "NumUsers": 2, "MaxUsers": 2, "internalIP": "10.124.33.92", "MACAddress": "4F-2F-6A-3C-29-FF", "ADSTRING": "", "Workgroup": "WORKGROUP", "DNSServer": "10.248.41.90", "BinType": "SMEINSTALL", "Email": "", "OtherAVProduct": "", "OtherAVProductVersion": "", "IsOtherAVEnabled": false, "IsOtherAVUpdated": false, "PrimaryBrowser": "IE", "PrimaryBrowserVersion": "9.11.9600.18125", "IsFirewallEnabled": true, "IsVirtualMachine": false, "IPV4": "10.124.33.92", "IPV6": "", "FQDN": "", "NTDOMAIN": "", "LDAPOID": "", "LDAPDN": "" }, "MasterKC": "89F1-AD81-3FB0-4F61-9765", "KC": "DB5F-B687-0117-43C1-9534", "MachineID": "65901865c2eb497183255658300b510565901865c2eb497183255658300b5105:::0b530cebe68e4de99ace0b530cebe68e4de99ace:::0b530cebe68e4de99ace0b530cebe68e4de99ace", "LastChanged": "2025-05-12T14:31:24.8218146Z", "HostName": "Computer1", "IPAddress": "95.94.204.234", "ClientVersion": "9.0.13.58", "OS": "Windows Server 2012 (Build 9600) 64bit", "FirstSeen": "2025-04-14T14:31:24.8218146Z", "LastSeen": "2025-05-13T14:31:24.8218146Z", "TimesSeen": 9, "Hidden": false, "Deactivated": false, "ActivationStatusTime": null }, { "BasicInfo": { "StatusRefreshTime": "2025-05-14T14:11:24.8218146Z", "Managed": false, "SKU": "Webroot SecureAnywhere Endpoint Protection", "PartnerNumber": 0, "Version": "9.0.13.58", "ActiveThreats": 0, "DeviceType": "PC", "AttentionRequired": false, "Infected": false }, "ExtendedInfo": { "Uninstalled": false, "Language": "en", "IsExpired": false, "DaysRemaining": 122, "ExpirationDate": "2025-09-13T14:31:24.8218146Z", "RemediationEnabled": true, "ThreatBlocked": false, "WasJustInfected": true, "HasBeenInfected": true, "LatestThreat": "c:\\users\\administrator\\downloads\\eicar_com\\eicar - copy.com|Eicar-Test-Virus|56A0F8A9", "CurrentlyCleaning": false, "CleanShutdown": true, "ManualAgentShutdown": false, "AgentStartupTime": "2025-05-14T04:31:24.8218146Z", "SystemState": 1, "SystemStateUpdated": "2025-05-14T04:31:24.8218146Z" }, "TimesAndStats": { "LastGarbageRemovalTime": null, "LastGarbageRemovalSize": 0, "TotalGarbageRemovalSize": 0, "LastScan": "2025-05-14T10:31:24.8218146Z", "LastScanDuration": 116, "LastScanCount": 197590, "ScanCount": 2, "ThreatsRemoved": 1, "LastQuickScan": null, "LastQuickScanDuration": 0, "LastFullScan": "2025-05-14T10:31:24.8218146Z", "LastFullScanDuration": 483, "LastCustomScan": null, "LastCustomScanDuration": 0, "LastDeepScan": null, "LastDeepScanDuration": 0 }, "Scheduling": { "ScheduledScansEnabled": true, "ScheduledScanFrequency": 0, "ScheduledScanTime": "10:00", "ScanWhenIdle": false, "ScanOnBootup": false, "ActiveScans": 0 }, "EnabledFeatures": { "ProtectionEnabled": true, "RootkitShieldEnabled": true, "WebThreatShieldEnabled": true, "USBShieldEnabled": true, "OfflineShieldEnabled": true, "ScriptShieldStatus": null, "FirewallEnabled": true, "InfraredEnabled": true, "IDShieldEnabled": true, "PhishingShieldEnabled": true, "IsSilent": false }, "SystemAnalyzer": { "SystemAnalyzerScore": 0, "HardwareScore": "", "SoftwareScore": "", "ThreatsScore": "" }, "OSAndVersions": { "OSBuild": 9600, "OSPlatform": 64, "OSLanguage": 1033, "CurrentUser": "Administrator", "NumUsers": 2, "MaxUsers": 2, "internalIP": "10.85.63.117", "MACAddress": "03-FE-88-81-C1-55", "ADSTRING": "", "Workgroup": "WORKGROUP", "DNSServer": "10.125.98.174", "BinType": "SMEINSTALL", "Email": "", "OtherAVProduct": "", "OtherAVProductVersion": "", "IsOtherAVEnabled": false, "IsOtherAVUpdated": false, "PrimaryBrowser": "IE", "PrimaryBrowserVersion": "9.11.9600.18125", "IsFirewallEnabled": true, "IsVirtualMachine": false, "IPV4": "10.85.63.117", "IPV6": "", "FQDN": "", "NTDOMAIN": "", "LDAPOID": "", "LDAPDN": "" }, "MasterKC": "89F1-AD81-3FB0-4F61-9765", "KC": "DB5F-B687-0117-43C1-9534", "MachineID": "86b7931b531548eb81abfc0e4cb15c9f86b7931b531548eb81abfc0e4cb15c9f:::42ad384633c9451ba4bb42ad384633c9451ba4bb:::42ad384633c9451ba4bb42ad384633c9451ba4bb", "LastChanged": "2025-05-10T14:31:24.8218146Z", "HostName": "Computer2", "IPAddress": "95.195.190.149", "ClientVersion": "9.0.13.58", "OS": "Windows Server 2012 (Build 9600) 64bit", "FirstSeen": "2025-03-14T14:31:24.8218146Z", "LastSeen": "2025-05-12T14:31:24.8218146Z", "TimesSeen": 17, "Hidden": false, "Deactivated": false, "ActivationStatusTime": null } ], "ContinuationToken": null, "ContinuationURI": null, "Count": 2 }
<AgentStatus xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Webroot.UnityAPI.ServiceExtension.AgentStatus.Models"> <ContinuationToken i:nil="true" /> <ContinuationURI i:nil="true" /> <Count>2</Count> <QueryResults> <EndpointInfo> <ActivationStatusTime i:nil="true" /> <BasicInfo> <ActiveThreats>0</ActiveThreats> <AttentionRequired>false</AttentionRequired> <DeviceType>PC</DeviceType> <Infected>false</Infected> <Managed>false</Managed> <PartnerNumber>0</PartnerNumber> <SKU>Webroot SecureAnywhere Endpoint Protection</SKU> <StatusRefreshTime>2025-05-14T14:21:24.8218146Z</StatusRefreshTime> <Version>9.0.13.58</Version> </BasicInfo> <ClientVersion>9.0.13.58</ClientVersion> <Deactivated>false</Deactivated> <EnabledFeatures> <FirewallEnabled>true</FirewallEnabled> <IDShieldEnabled>true</IDShieldEnabled> <InfraredEnabled>true</InfraredEnabled> <IsSilent>false</IsSilent> <OfflineShieldEnabled>true</OfflineShieldEnabled> <PhishingShieldEnabled>true</PhishingShieldEnabled> <ProtectionEnabled>true</ProtectionEnabled> <RootkitShieldEnabled>true</RootkitShieldEnabled> <ScriptShieldStatus i:nil="true" /> <USBShieldEnabled>true</USBShieldEnabled> <WebThreatShieldEnabled>true</WebThreatShieldEnabled> </EnabledFeatures> <ExtendedInfo> <AgentStartupTime>2025-05-14T09:31:24.8218146Z</AgentStartupTime> <CleanShutdown>true</CleanShutdown> <CurrentlyCleaning>false</CurrentlyCleaning> <DaysRemaining>122</DaysRemaining> <ExpirationDate>2025-09-13T14:31:24.8218146Z</ExpirationDate> <HasBeenInfected>true</HasBeenInfected> <IsExpired>false</IsExpired> <Language>en</Language> <LatestThreat>c:\users\administrator\downloads\eicar_com\eicar - copy.com|Eicar-Test-Virus|56A0F8A9</LatestThreat> <ManualAgentShutdown>false</ManualAgentShutdown> <RemediationEnabled>true</RemediationEnabled> <SystemState>1</SystemState> <SystemStateUpdated>2025-05-14T09:31:24.8218146Z</SystemStateUpdated> <ThreatBlocked>false</ThreatBlocked> <Uninstalled>false</Uninstalled> <WasJustInfected>true</WasJustInfected> </ExtendedInfo> <FirstSeen>2025-04-14T14:31:24.8218146Z</FirstSeen> <Hidden>false</Hidden> <HostName>Computer1</HostName> <IPAddress>95.94.204.234</IPAddress> <KC>DB5F-B687-0117-43C1-9534</KC> <LastChanged>2025-05-12T14:31:24.8218146Z</LastChanged> <LastSeen>2025-05-13T14:31:24.8218146Z</LastSeen> <MachineID>65901865c2eb497183255658300b510565901865c2eb497183255658300b5105:::0b530cebe68e4de99ace0b530cebe68e4de99ace:::0b530cebe68e4de99ace0b530cebe68e4de99ace</MachineID> <MasterKC>89F1-AD81-3FB0-4F61-9765</MasterKC> <OS>Windows Server 2012 (Build 9600) 64bit</OS> <OSAndVersions> <ADSTRING></ADSTRING> <BinType>SMEINSTALL</BinType> <CurrentUser>Administrator</CurrentUser> <DNSServer>10.248.41.90</DNSServer> <Email></Email> <FQDN></FQDN> <IPV4>10.124.33.92</IPV4> <IPV6></IPV6> <IsFirewallEnabled>true</IsFirewallEnabled> <IsOtherAVEnabled>false</IsOtherAVEnabled> <IsOtherAVUpdated>false</IsOtherAVUpdated> <IsVirtualMachine>false</IsVirtualMachine> <LDAPDN></LDAPDN> <LDAPOID></LDAPOID> <MACAddress>4F-2F-6A-3C-29-FF</MACAddress> <MaxUsers>2</MaxUsers> <NTDOMAIN></NTDOMAIN> <NumUsers>2</NumUsers> <OSBuild>9600</OSBuild> <OSLanguage>1033</OSLanguage> <OSPlatform>64</OSPlatform> <OtherAVProduct></OtherAVProduct> <OtherAVProductVersion></OtherAVProductVersion> <PrimaryBrowser>IE</PrimaryBrowser> <PrimaryBrowserVersion>9.11.9600.18125</PrimaryBrowserVersion> <Workgroup>WORKGROUP</Workgroup> <internalIP>10.124.33.92</internalIP> </OSAndVersions> <Scheduling> <ActiveScans>0</ActiveScans> <ScanOnBootup>false</ScanOnBootup> <ScanWhenIdle>false</ScanWhenIdle> <ScheduledScanFrequency>0</ScheduledScanFrequency> <ScheduledScanTime>10:00</ScheduledScanTime> <ScheduledScansEnabled>true</ScheduledScansEnabled> </Scheduling> <SystemAnalyzer> <HardwareScore></HardwareScore> <SoftwareScore></SoftwareScore> <SystemAnalyzerScore>0</SystemAnalyzerScore> <ThreatsScore></ThreatsScore> </SystemAnalyzer> <TimesAndStats> <LastCustomScan i:nil="true" /> <LastCustomScanDuration>0</LastCustomScanDuration> <LastDeepScan i:nil="true" /> <LastDeepScanDuration>0</LastDeepScanDuration> <LastFullScan>2025-05-14T12:31:24.8218146Z</LastFullScan> <LastFullScanDuration>738</LastFullScanDuration> <LastGarbageRemovalSize>0</LastGarbageRemovalSize> <LastGarbageRemovalTime i:nil="true" /> <LastQuickScan i:nil="true" /> <LastQuickScanDuration>0</LastQuickScanDuration> <LastScan>2025-05-14T12:31:24.8218146Z</LastScan> <LastScanCount>126773</LastScanCount> <LastScanDuration>223</LastScanDuration> <ScanCount>5</ScanCount> <ThreatsRemoved>1</ThreatsRemoved> <TotalGarbageRemovalSize>0</TotalGarbageRemovalSize> </TimesAndStats> <TimesSeen>9</TimesSeen> </EndpointInfo> <EndpointInfo> <ActivationStatusTime i:nil="true" /> <BasicInfo> <ActiveThreats>0</ActiveThreats> <AttentionRequired>false</AttentionRequired> <DeviceType>PC</DeviceType> <Infected>false</Infected> <Managed>false</Managed> <PartnerNumber>0</PartnerNumber> <SKU>Webroot SecureAnywhere Endpoint Protection</SKU> <StatusRefreshTime>2025-05-14T14:11:24.8218146Z</StatusRefreshTime> <Version>9.0.13.58</Version> </BasicInfo> <ClientVersion>9.0.13.58</ClientVersion> <Deactivated>false</Deactivated> <EnabledFeatures> <FirewallEnabled>true</FirewallEnabled> <IDShieldEnabled>true</IDShieldEnabled> <InfraredEnabled>true</InfraredEnabled> <IsSilent>false</IsSilent> <OfflineShieldEnabled>true</OfflineShieldEnabled> <PhishingShieldEnabled>true</PhishingShieldEnabled> <ProtectionEnabled>true</ProtectionEnabled> <RootkitShieldEnabled>true</RootkitShieldEnabled> <ScriptShieldStatus i:nil="true" /> <USBShieldEnabled>true</USBShieldEnabled> <WebThreatShieldEnabled>true</WebThreatShieldEnabled> </EnabledFeatures> <ExtendedInfo> <AgentStartupTime>2025-05-14T04:31:24.8218146Z</AgentStartupTime> <CleanShutdown>true</CleanShutdown> <CurrentlyCleaning>false</CurrentlyCleaning> <DaysRemaining>122</DaysRemaining> <ExpirationDate>2025-09-13T14:31:24.8218146Z</ExpirationDate> <HasBeenInfected>true</HasBeenInfected> <IsExpired>false</IsExpired> <Language>en</Language> <LatestThreat>c:\users\administrator\downloads\eicar_com\eicar - copy.com|Eicar-Test-Virus|56A0F8A9</LatestThreat> <ManualAgentShutdown>false</ManualAgentShutdown> <RemediationEnabled>true</RemediationEnabled> <SystemState>1</SystemState> <SystemStateUpdated>2025-05-14T04:31:24.8218146Z</SystemStateUpdated> <ThreatBlocked>false</ThreatBlocked> <Uninstalled>false</Uninstalled> <WasJustInfected>true</WasJustInfected> </ExtendedInfo> <FirstSeen>2025-03-14T14:31:24.8218146Z</FirstSeen> <Hidden>false</Hidden> <HostName>Computer2</HostName> <IPAddress>95.195.190.149</IPAddress> <KC>DB5F-B687-0117-43C1-9534</KC> <LastChanged>2025-05-10T14:31:24.8218146Z</LastChanged> <LastSeen>2025-05-12T14:31:24.8218146Z</LastSeen> <MachineID>86b7931b531548eb81abfc0e4cb15c9f86b7931b531548eb81abfc0e4cb15c9f:::42ad384633c9451ba4bb42ad384633c9451ba4bb:::42ad384633c9451ba4bb42ad384633c9451ba4bb</MachineID> <MasterKC>89F1-AD81-3FB0-4F61-9765</MasterKC> <OS>Windows Server 2012 (Build 9600) 64bit</OS> <OSAndVersions> <ADSTRING></ADSTRING> <BinType>SMEINSTALL</BinType> <CurrentUser>Administrator</CurrentUser> <DNSServer>10.125.98.174</DNSServer> <Email></Email> <FQDN></FQDN> <IPV4>10.85.63.117</IPV4> <IPV6></IPV6> <IsFirewallEnabled>true</IsFirewallEnabled> <IsOtherAVEnabled>false</IsOtherAVEnabled> <IsOtherAVUpdated>false</IsOtherAVUpdated> <IsVirtualMachine>false</IsVirtualMachine> <LDAPDN></LDAPDN> <LDAPOID></LDAPOID> <MACAddress>03-FE-88-81-C1-55</MACAddress> <MaxUsers>2</MaxUsers> <NTDOMAIN></NTDOMAIN> <NumUsers>2</NumUsers> <OSBuild>9600</OSBuild> <OSLanguage>1033</OSLanguage> <OSPlatform>64</OSPlatform> <OtherAVProduct></OtherAVProduct> <OtherAVProductVersion></OtherAVProductVersion> <PrimaryBrowser>IE</PrimaryBrowser> <PrimaryBrowserVersion>9.11.9600.18125</PrimaryBrowserVersion> <Workgroup>WORKGROUP</Workgroup> <internalIP>10.85.63.117</internalIP> </OSAndVersions> <Scheduling> <ActiveScans>0</ActiveScans> <ScanOnBootup>false</ScanOnBootup> <ScanWhenIdle>false</ScanWhenIdle> <ScheduledScanFrequency>0</ScheduledScanFrequency> <ScheduledScanTime>10:00</ScheduledScanTime> <ScheduledScansEnabled>true</ScheduledScansEnabled> </Scheduling> <SystemAnalyzer> <HardwareScore></HardwareScore> <SoftwareScore></SoftwareScore> <SystemAnalyzerScore>0</SystemAnalyzerScore> <ThreatsScore></ThreatsScore> </SystemAnalyzer> <TimesAndStats> <LastCustomScan i:nil="true" /> <LastCustomScanDuration>0</LastCustomScanDuration> <LastDeepScan i:nil="true" /> <LastDeepScanDuration>0</LastDeepScanDuration> <LastFullScan>2025-05-14T10:31:24.8218146Z</LastFullScan> <LastFullScanDuration>483</LastFullScanDuration> <LastGarbageRemovalSize>0</LastGarbageRemovalSize> <LastGarbageRemovalTime i:nil="true" /> <LastQuickScan i:nil="true" /> <LastQuickScanDuration>0</LastQuickScanDuration> <LastScan>2025-05-14T10:31:24.8218146Z</LastScan> <LastScanCount>197590</LastScanCount> <LastScanDuration>116</LastScanDuration> <ScanCount>2</ScanCount> <ThreatsRemoved>1</ThreatsRemoved> <TotalGarbageRemovalSize>0</TotalGarbageRemovalSize> </TimesAndStats> <TimesSeen>17</TimesSeen> </EndpointInfo> </QueryResults> </AgentStatus>