GET /service/api/status/gsm/dnsp/{keyCode}
?machineId={machineId}
&modifiedSince={modifiedSince}
&batchSize={batchSize}
&continuation={continuation}
Returns DNS protection (DNSP) status information for all endpoints matching the specified criteria.
Request Information
URI Parameters
| Name | Description | Type | Additional Information |
|---|---|---|---|
| keyCode |
A GSM parent keycode for which DNSP status information is to be retrieved. |
string |
Required |
| machineId |
A machine ID for which DNSP status information is to be retrieved. If omitted, information for all endpoints is for the given site is retrieved. |
string |
None. |
| modifiedSince |
If specified, returns all DNSP status entries, that were modified after (or at) the given date. |
date |
None. |
| batchSize |
Specifies the maximum 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/dnsp/3515-3EC8-3018-4DAB-A776?batchSize=200
|
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?batchSize=200&continuation=H4sIAAAAAAAEAM1SS07DMBQckiBVXXXDATgB8bd2d5RuAmkLilhHsetISGkrlMBVuBBnQGLJgnvgkLRdgYQEEgtrPO_Nm-dn-z4EonWeNG5NcAZgFCN5eT4fEVy2QHHVAkPaAsd1CwI3HhB2dRTHvm7nwnDqSRDjxAPTTDauboxZ2RV1jq_IGLs6jtfAk6sLvHnpcIrBdLlMgUFSt5vMNd50mvXuaYc-2WXC
|
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?machineId=8a8a1a12345c1ca9eelw78965a9c8d789c6fc75381d1234567890fffa91c138:::57cf6d537c9a3e12345bbdaa8ba2a98765c1c5c2:::57cf6d123c9a3e12345bbdaa8ba2a98765c1c5c2
|
|
GET
|
https://unityapi.webrootcloudav.com/service/api/status/gsm/dnsp/3515-3EC8-3018-4DAB-A776?modifiedSince=2019-01-01T22:30:00.000Z
|
Body Parameters
None.
Response Information
Resource Description
Returns DNSP status information for the 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
DNSPAgentStatus| Name | 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 DNSP endpoints returned in the current request. |
integer |
None. |
| QueryResults |
Endpoint information matching the given query parameters. |
Collection of DNSPEndpointInfo |
None. |
Sample Response
{
"QueryResults": [
{
"HostName": "Computer1",
"IsVirtualMachine": false,
"DNSAgentStatus": "Installed",
"InstalledDate": "2026-05-15T00:30:08.4509149Z",
"UninstalledDate": null,
"AgentVersion": "1.3.3.35",
"LastSeenDate": "2026-06-13T00:30:08.4509149Z",
"LastModifiedDate": "2026-05-15T02:30:08.4509149Z",
"TrafficCountLast24Hours": 2134,
"DNSPolicyID": "2bc3d45b-38dc-43c2-b7d0-824a95d53c52",
"DNSPolicyName": "Securedns High Protection",
"MachineID": "80a2a35462bb4f9cb1b5f80b3801fbac80a2a35462bb4f9cb1b5f80b3801fbac:::2f5d72ec2e8e45ff9dc42f5d72ec2e8e45ff9dc4:::2f5d72ec2e8e45ff9dc42f5d72ec2e8e45ff9dc4",
"KC": "C456-CEBA-396D-4E91-B41E",
"MasterKC": "7DEE-FD80-866D-483A-95DE"
},
{
"HostName": "Computer2",
"IsVirtualMachine": false,
"DNSAgentStatus": "Installed",
"InstalledDate": "2026-04-15T00:30:08.4509149Z",
"UninstalledDate": null,
"AgentVersion": "1.3.3.35",
"LastSeenDate": "2026-06-11T00:30:08.4509149Z",
"LastModifiedDate": "2026-04-15T04:30:08.4509149Z",
"TrafficCountLast24Hours": 2134,
"DNSPolicyID": "efbd698c-b73d-449f-82ea-acda5b6cf5af",
"DNSPolicyName": "Securedns High Protection",
"MachineID": "459d9d41aa6c4193a6dae4c42e1171c8459d9d41aa6c4193a6dae4c42e1171c8:::3c86d53f8cd4448aa9813c86d53f8cd4448aa981:::3c86d53f8cd4448aa9813c86d53f8cd4448aa981",
"KC": "C456-CEBA-396D-4E91-B41E",
"MasterKC": "7DEE-FD80-866D-483A-95DE"
}
],
"ContinuationToken": null,
"ContinuationURI": null,
"Count": 2
}
<DNSPAgentStatus 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>
<DNSPEndpointInfo>
<AgentVersion>1.3.3.35</AgentVersion>
<DNSAgentStatus>Installed</DNSAgentStatus>
<DNSPolicyID>2bc3d45b-38dc-43c2-b7d0-824a95d53c52</DNSPolicyID>
<DNSPolicyName>Securedns High Protection</DNSPolicyName>
<HostName>Computer1</HostName>
<InstalledDate>2026-05-15T00:30:08.4509149Z</InstalledDate>
<IsVirtualMachine>false</IsVirtualMachine>
<KC>C456-CEBA-396D-4E91-B41E</KC>
<LastModifiedDate>2026-05-15T02:30:08.4509149Z</LastModifiedDate>
<LastSeenDate>2026-06-13T00:30:08.4509149Z</LastSeenDate>
<MachineID>80a2a35462bb4f9cb1b5f80b3801fbac80a2a35462bb4f9cb1b5f80b3801fbac:::2f5d72ec2e8e45ff9dc42f5d72ec2e8e45ff9dc4:::2f5d72ec2e8e45ff9dc42f5d72ec2e8e45ff9dc4</MachineID>
<MasterKC>7DEE-FD80-866D-483A-95DE</MasterKC>
<TrafficCountLast24Hours>2134</TrafficCountLast24Hours>
<UninstalledDate i:nil="true" />
</DNSPEndpointInfo>
<DNSPEndpointInfo>
<AgentVersion>1.3.3.35</AgentVersion>
<DNSAgentStatus>Installed</DNSAgentStatus>
<DNSPolicyID>efbd698c-b73d-449f-82ea-acda5b6cf5af</DNSPolicyID>
<DNSPolicyName>Securedns High Protection</DNSPolicyName>
<HostName>Computer2</HostName>
<InstalledDate>2026-04-15T00:30:08.4509149Z</InstalledDate>
<IsVirtualMachine>false</IsVirtualMachine>
<KC>C456-CEBA-396D-4E91-B41E</KC>
<LastModifiedDate>2026-04-15T04:30:08.4509149Z</LastModifiedDate>
<LastSeenDate>2026-06-11T00:30:08.4509149Z</LastSeenDate>
<MachineID>459d9d41aa6c4193a6dae4c42e1171c8459d9d41aa6c4193a6dae4c42e1171c8:::3c86d53f8cd4448aa9813c86d53f8cd4448aa981:::3c86d53f8cd4448aa9813c86d53f8cd4448aa981</MachineID>
<MasterKC>7DEE-FD80-866D-483A-95DE</MasterKC>
<TrafficCountLast24Hours>2134</TrafficCountLast24Hours>
<UninstalledDate i:nil="true" />
</DNSPEndpointInfo>
</QueryResults>
</DNSPAgentStatus>