10 requests every 60 seconds.
External DocumentationTo learn more, visit the ThreatAware documentation.
Parameters
| Parameter | Description |
|---|---|
| Filter | Select the device state to filter results by. |
| Limit | The maximum number of results to return. Enter 0 to return all available entries. |
| Offset | The start position of the data returned by the API. |
Example Output
{
"offset": 0,
"limit": 1,
"total": 100,
"data": [
{
"hostName": "BAM-001-FJ23Y",
"os": "Windows",
"osVersion": "Windows 11",
"lastOnline": "2022-10-10T08:49:28.0000000",
"location": {
"countryCode": "gb",
"country": "United Kingdom",
"city": "London"
},
"tags": [],
"metadata": {
"warranty_expiry": "2022-10-10 08:33:18",
"serial_number": "F11929BD2CF8",
"total_disk_storage": "230 GB",
"free_disk_storage": "31 GB",
"total_memory": "32 GB",
"cpu_speed": "2.91 GHz",
"model": "XPS 13",
"manufacturer": "Dell"
},
"lastUser": {
"name": "Douglas Campbell",
"email": "douglas.campbell@bam.com"
},
"lastLogin": "2022-10-10T08:49:28.0000000",
"publicIp": "134.198.61.169",
"privateIp": "10.62.224.187",
"macAddress": "8E:C5:D0:53:74:AE",
"securityTools": [
{
"name": "Automox",
"redAlerts": 0,
"amberAlerts": 1
},
{
"name": "Bitdefender",
"redAlerts": 0,
"amberAlerts": 0
},
{
"name": "Cisco Umbrella",
"redAlerts": 0,
"amberAlerts": 1
}
],
"connectedSystems": [
{
"name": "Tenable IO",
"isConnected": true,
"isActive": true
},
{
"name": "Azure AD",
"isConnected": true,
"isActive": true
},
{
"name": "Teamviewer",
"isConnected": true,
"isActive": true
}
]
}
],
"success": true,
"statusCode": 200,
"message": "Successfully retrieved devices."
}