GET OneStop/Groups/{GroupID}/Devices?IncludeSubGroups={IncludeSubGroups}&Managed={Managed}
Gets a summary of devices in the specified group
Request Information
URI Parameters
| Name | Description | Type | Additional information |
|---|---|---|---|
| GroupID | integer |
Required |
|
| IncludeSubGroups |
Whether to include devices in subgroups |
boolean |
Default value is True |
| Managed |
Whether to include only managed, or all devices. Defaults to true |
boolean |
Default value is True |
Body Parameters
None.
Response Information
Resource Description
Collection of DeviceSummaryDTO| Name | Description | Type | Additional information |
|---|---|---|---|
| DeviceID |
Auto generated |
integer |
None. |
| IPAddress |
IP Address of device |
string |
None. |
| MacAddress |
MAC Address of device in the format AA:AA:AA:AA:AA:AA |
string |
None. |
| Description |
Device Description. OID 1.3.6.1.2.1.25.3.2.1.3 |
string |
None. |
| SerialNumber |
Device Serial Number |
string |
None. |
| Location |
Device location. Retrieved from OID 1.3.6.1.2.1.1.6 |
string |
None. |
| Manufacturer |
Device manufacturer |
string |
None. |
| Model |
Device model name |
string |
None. |
| GroupID |
Group ID of device |
integer |
None. |
| AssetNumber |
Device asset number if set |
string |
None. |
| Comments |
Any comments that have been added for the device |
string |
None. |
| LastCommunication |
Last time any commination received from the device |
date |
None. |
| GroupName |
Name of group device appears in |
string |
None. |
Response Formats
application/json, text/json
[
{
"DeviceID": 1,
"IPAddress": "sample string 2",
"MacAddress": "sample string 3",
"Description": "sample string 4",
"SerialNumber": "sample string 5",
"Location": "sample string 6",
"Manufacturer": "sample string 7",
"Model": "sample string 8",
"GroupID": 1,
"AssetNumber": "sample string 9",
"Comments": "sample string 10",
"LastCommunication": "2026-07-07T14:50:16.3443634+01:00",
"GroupName": "sample string 11"
},
{
"DeviceID": 1,
"IPAddress": "sample string 2",
"MacAddress": "sample string 3",
"Description": "sample string 4",
"SerialNumber": "sample string 5",
"Location": "sample string 6",
"Manufacturer": "sample string 7",
"Model": "sample string 8",
"GroupID": 1,
"AssetNumber": "sample string 9",
"Comments": "sample string 10",
"LastCommunication": "2026-07-07T14:50:16.3443634+01:00",
"GroupName": "sample string 11"
}
]
application/xml, text/xml
<ArrayOfDeviceSummaryDTO xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/OneStopWebAPI.DTO">
<DeviceSummaryDTO>
<AssetNumber>sample string 9</AssetNumber>
<Comments>sample string 10</Comments>
<Description>sample string 4</Description>
<DeviceID>1</DeviceID>
<GroupID>1</GroupID>
<GroupName>sample string 11</GroupName>
<IPAddress>sample string 2</IPAddress>
<LastCommunication>2026-07-07T14:50:16.3443634+01:00</LastCommunication>
<Location>sample string 6</Location>
<MacAddress>sample string 3</MacAddress>
<Manufacturer>sample string 7</Manufacturer>
<Model>sample string 8</Model>
<SerialNumber>sample string 5</SerialNumber>
</DeviceSummaryDTO>
<DeviceSummaryDTO>
<AssetNumber>sample string 9</AssetNumber>
<Comments>sample string 10</Comments>
<Description>sample string 4</Description>
<DeviceID>1</DeviceID>
<GroupID>1</GroupID>
<GroupName>sample string 11</GroupName>
<IPAddress>sample string 2</IPAddress>
<LastCommunication>2026-07-07T14:50:16.3443634+01:00</LastCommunication>
<Location>sample string 6</Location>
<MacAddress>sample string 3</MacAddress>
<Manufacturer>sample string 7</Manufacturer>
<Model>sample string 8</Model>
<SerialNumber>sample string 5</SerialNumber>
</DeviceSummaryDTO>
</ArrayOfDeviceSummaryDTO>